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* The HID’s interrupt IN endpoint is NAKing the IN token packets because 
the endpoint hasnt been armed to send report data. An endpoints inter- 
rupt typically triggers only after endpoint sends data, so the device must 
arm the endpoint to send the first report before the first interrupt. 

e The number of bytes the endpoint is sending doesn’t equal the number of 
bytes in a report (for HIDs that use the default Report ID) or the number 
of bytes in a report + 1 (for HIDs that use other Report IDs). 

* For HIDs with multiple Report IDs, the first byte doesn’t match a valid 
Report ID. 


Writing a Feature Report to the Device 


To send a Feature report to a device, use HidD_SetFeature, which sends a Set 
Report request and a report in a control transfer. 
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Definitions 
«DIlImport("hid.dll", SetLastError:=True)> _ 
Shared Function HidD_SetFeature _ 
(ByVal HidDeviceObject As SafeFileHandle, _ 
ByVal IpReportBuffer() As Byte, _ 
ByVal ReportBufferLength As Int32) _ 
As Boolean 
End Function 


Use 


Dim outFeatureReportBuffer() As Byte = Nothing 
Dim success As Boolean 


Array.Resize(outFeatureReportBuffer, Capabilities.FeatureReportByteLength) 
' Store the Report ID in the first byte of the buffer: 
outFeatureReportBuffer(0) = 0 

' Store the report data following the Report ID. Example: 


outFeatureReportBuffer(1) = 79 
outFeatureReportBuffer(2) = 75 


success = HidD SetFeature _ 
(deviceHandle, _ 
outFeatureReportBuffer, _ 
outFeatureReportBuffer.Length) 


Definitions 
[ Dillmport( "hid.dll", SetLastError=true ) ] 
internal static extern Boolean HidD_SetFeature 
( SafeFileHandle HidDeviceObject, 
Byte IpReportBuffer[], 
Int32 ReportBufferLength ); 


Use 


Byte[] outFeatureReportBuffer - null; 
Boolean success - false; 


Array.Resize(ref outFeatureReportBuffer, Capabilities.FeatureReportByteLength); 


Human Interface Devices: Host Application 


// Store the Report ID in the first byte of the buffer: 
outFeaturetReportBuffer[ 0 ] = 0; 
// Store the report data following the Report ID. Example: 


outFeatureReportBuffer[ 1 


79; 
outFeatureReportBuffer[ 2 5 


J= 

]27 

success = HidD. SetFeature 
(deviceHandle, 


outFeatureReportBuffer, 
outFeatureReportBuffer.Length); 


Details 


HidD. SetFeature requires a handle to the HID, an array to write, and the 
arrays length. The first byte in the outFeatureReportBuffer array is the Report 
ID. The array's length is in the HIDP_CAPS structure retrieved by 
HidP_GetCaps. 


The function returns true on success. If the device continues to NAK the report 
data, the function times out and returns. 


A call to HidD_SetOutputReport works in much the same way to send an 
Output report using a control transfer. The function passes a handle to the 
HID, a pointer to a byte array containing an Output report, and the number of 
bytes in the report plus one byte for the Report ID. 


Reading a Feature Report from a Device 


VB 


To read a Feature report from a device, use HidD_GetFeature, which sends a 
Get_Feature request in a control transfer. The endpoint returns the report in 
the Data stage. 


Definitions 


<Dillmport(‘hid.dll’, SetLastError:=True)> _ 
Shared Function HidD_GetFeature _ 
(ByVal HidDeviceObject As SafeFileHandle, _ 
ByVal IpReportBuffer() As Byte, _ 
ByVal ReportBufferLength As Int32) _ 
As Boolean 
End Function 
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Use 


Dim inFeatureReportBuffer() As Byte = Nothing 
Dim success As Boolean 


Array.Resize(inFeatureReportBuffer, Capabilities.FeatureReportByteLength) 
"The first byte in the report buffer is the Report ID: 
InFeatureReportBuffer(0) = 0 


success = HidD_GetFeature _ 
(deviceHandle, _ 
inFeatureReportBuffer, _ 
inFeatureReportBuffer.Length) 


Definitions 


[ Dillmport( "hid.dll", SetLastError=true ) ] 
internal static extern Boolean HidD_GetFeature 
( SafeFileHandle HidDeviceObject, 
Byte[] IpReportBuffer, 
Int32 ReportBufferLength ); 


Use 


Byte[] inFeatureReportBuffer = null; 
Boolean success - false; 


Array.Resize(ref inFeatureReportBuffer, Capabilities.FeatureReportByteLength); 
// The first byte in the report buffer is the Report ID: 
inFeatureReportBuffer[0] = 0; 


success = HidD  GetFeature 
(deviceHandle, 
inFeatureReportBuffer, 
inFeatureReportBuffer.Length); 


Details 


HidD_GetFeature requires a handle to the HID, an array to hold the retrieved 
report(s), and the array’s length. The inFeatureReportBuffer array holds the 
retrieved report. The first byte in the array is the Report ID. The array’s length 
is in the HIDP_CAPS structure retrieved by HidP_GetCaps. 


Human Interface Devices: Host Application 


The function returns true on success. If the device continues to return NAK in 
the Data stage of the transfer, the function times out and returns. 


A call to HidD_GetInputReport works in much the same way to request an 
Input report using a control transfer. The function passes a handle to the HID, 
an array to hold the Input report, and the number of bytes in the report plus 
one byte for the Report ID. 


Closing Communications 


VB 
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When finished communicating, the application should call the Close method 
to close any SafeFileHandles opened by CreateFile as described in Chapter 10. 
When finished using the PreparsedData buffer that HidD_GetPreparsedData 
returned, the application should call HidD_FreePreparsedData. 


Definitions 

<Dillmport(‘hid.dll’, SetLastError:=True)> _ 

Shared Function HidD_FreePreparsedData _ 
(ByVal PreparsedData As IntPtr) _ 
As Boolean 
End Function 

Use 

Dim success As Boolean 


success = HidD_FreePreparsedData(preparsedData) 


Definitions 


[ Dillmport( "hid.dll", SetLastError-true ) ] 
internal static extern Boolean HidD_FreePreparsedData 
( IntPtr PreparsedData ); 


Use 
Boolean success = false; 


success = HidD_FreePreparsedData( preparsedData ); 
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Using WinUSB for 
Vendor-Defined Functions 


An option for devices that perform vendor-specific functions is Microsoft's 
WinUSB driver. This chapter shows how to develop a device that uses the 
WinUSB driver and how to use the WinUSB API to access the device from 
applications. 


Capabilities and Limits 


A device is a candidate for using the WinUSB driver if the device and its host 
computer(s) meet the requirements below. 


Device Requirements 
The device: 


* Exchanges application data using any combination of control, interrupt, 
and bulk endpoints. (The driver doesn’t support isochronous transfers.) 


* Has descriptors that specify a vendor-specific class. 
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Host Requirements 


The host: 
* Is Windows XP SP2 or later. 
* Needs no more than one open handle to the device at once. 


* Has an INF file that contains the devices Vendor ID and Product ID and a 
vendor-defined device interface GUID. 

* Has the WinUSB driver and installation files. For Windows XB, the device 
vendor can provide the files, which are a free, redistributable download 
from Microsoft. Windows Vista systems include the files. 

* Has a vendor-provided application to communicate with the device. Pro- 
gramming languages for the application can include Visual Basic, Visual 
C£, and other languages that can call Windows API functions. 


Device Firmware 
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A WinUSB device has an interface descriptor with bInterfaceClass = FFh to 
indicate a vendor-specific class. Listing 14-1 shows descriptors for an example 
WinUSB device. Following the interface descriptor are endpoint descriptors for 
interrupt IN, interrupt OUT, bulk IN, and bulk OUT endpoints as needed. A 
device can also use vendor-specific control transfers. Unlike HID data, 
WinUSB data doesnt have to be in defined-length reports. 


Device firmware can respond to vendor-specific requests in control transfers. 
Firmware handles these transfers in much the same way as the HID Get Report 
and Set Report requests. The Setup packet can use any values for the wValue, 
wlIndex, and wLength fields. In the bmRequest Type field, bits 6..5 equal 10 to 
indicate a vendor-defined request. The bRequest field is a vendor-defined 
request number. 


For all of the transfer types, the host application and device firmware must 
agree on the data format. For example, for a data-acquisition device, firmware 
might define a vendor-specific control request with bRequest = 01h to identify 
the request, wIndex indicating which sensor reading to return, and wLength 
equal to the number of bytes the device should return with the requested data. 
Or the firmware might send sensor data in a defined format on an interrupt or 
bulk endpoint. In a similar way, a host application can send data to a device 
using control, bulk, or interrupt transfers. 
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Device Descriptor 


bLength 
bDescriptorType 
bcdUSB 
bDeviceClass 
bDeviceSubClass 
bDeviceProtocol 
bMaxPacketSize0 
idVendor 
idProduct 
bcdDevice 
iManufacturer 
iProduct 
iSerialNumber 


bNumConfigurations 


Configuration Descriptor 


bLength 
bDescriptorType 


wTotalLength 


bNuminterfaces 


bConfigurationValue 


iConfiguration 
bmAttributes 
bMaxPower 


Interface Descriptor 


bLength 
bDescriptorType 
bInterfaceNumber 
bAlternateSetting 
bNumEndpoints 
bInterfaceClass 
bInterfaceSubclass 
bInterfaceProtocol 
ilnterface 


Descriptor size in bytes 
Descriptor type (Device) 

USB Specification release number (BCD) (2.00) 
Class Code 

Subclass code 

Protocol code 

Endpoint 0 maximum packet size 
Vendor ID (Lakeview Research) 
Product ID 

Device release number (BCD) 
Manufacturer string index 
Product string index 

Device serial number string index 
Number of configurations 


Descriptor size in bytes 

Descriptor type (Configuration) 

Total length of this and subordinate descriptors 
Number of interfaces in this configuration 

Index of this configuration 

Configuration string index 

Attributes (self powered, remote wakeup supported) 
Maximum power consumption (100 mA) 


Descriptor size in bytes 

Descriptor type (Interface) 

Interface number 

Alternate setting number 

Number of endpoints in this interface 
Interface class (vendor specific) 
Interface subclass 

Interface protocol 

Interface string index 





Listing 14-1: Example descriptors for a WinUSB device. All values are in 
hexadecimal. (Part 1 of 2) 
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Interrupt IN Endpoint Descriptor 


07 bLength Descriptor size in bytes 
05 bDescriptorType Descriptor type (Endpoint) 
81 bEndpointAddress Endpoint number and direction (1 IN) 


03 bmAttributes Transfer type (interrupt) 
0008 wMaxPacketSize Maximum packet size 
0A bInterval polling interval (milliseconds) 


Interrupt OUT Endpoint Descriptor 


07 bLength Descriptor size in bytes 
05 bDescriptorType Descriptor type (Endpoint) 
01 bEndpointAddress Endpoint number and direction (1 OUT) 


03 bmAttributes Transfer type (interrupt) 
0008 wMaxPacketSize Maximum packet size 
0A bInterval polling interval (milliseconds) 


Bulk IN Endpoint Descriptor 


07 bLength Descriptor size in bytes 
05 bDescriptorType Descriptor type (Endpoint) 
82 bEndpointAddress Endpoint number and direction (2 IN) 


02 bmAttributes Transfer type (bulk) 
0040 wMaxPacketSize Maximum packet size 
00 bInterval polling interval (ignored) 


Bulk OUT Endpoint Descriptor 


07 bLength Descriptor size in bytes 
05 bDescriptorType Descriptor type (Endpoint) 
02 bEndpointAddress Endpoint number and direction (2 OUT) 


02 bmAttributes Transfer type (bulk) 
0040 wMaxPacketSize Maximum packet size 
00 bInterval polling interval (ignored) 





Listing 14-1: Example descriptors for a WinUSB device. All values are in 
hexadecimal. (Part 2 of 2) 
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Using WinUSB for Vendor-Defined Functions 


For PICBASIC PRO firmware for WinUSB, visit my website (www. Lvr.com). 


The Microchip USB Framework provides WinUSB firmware for the 
PIC18F4550 and other Microchip microcontrollers. The code supports send- 
ing and receiving data using bulk and interrupt transfers. For code that also 
supports control transfers, visit www. Lvr.com. 


Assigning the WinUSB Driver 


Installing a USB device that uses the WinUSB driver requires an INF file that 
identifies the device. Chapter 9 showed an INF file for a WinUSB device. Win- 
dows XP installations also require a free, redistributable coinstaller files from 
the WDK. 

The WinUSB coinstaller file is: 

WinUsbCoinstaller.dll 

located in: 

<winddk_home>\<build_number>\redist\winusb\<arch> 

where <winddk_home> and <build_number> are the home directory and subdi- 
rectory of the WDK and <arch> indicates a PC architecture such as x86 for 
32-bit systems, amd64 for AMD 64-bit systems, or ia64 for Itanium 64-bit sys- 
tems. For example, a 32-bit file for WDK build 6001 might be stored here: 
c:\winddk\6001\redist\winusb\x86 

The coinstaller contains the winusb.sys driver so you dont need to provide this 
file separately. The coinstaller installs the driver. 

The other needed WDK files are: 

WafColnstallerxxx.dll 

WUDFUpdate_xxx.dll 

where xxx represents the edition of the file. 

For WDK build 6001, the file names are: 

WdfCoinstaller01007.dll 

WudfUpdate 01007 .dll 

For other WDK builds, the file editions and file names may differ. Check the 
directories for the correct file names for your WDK. 

The files are located here: 

<winddk_home>\<build_number>\redist\wdf\<arch> 

where again <winddk_home> and <build_number> are the WDK’s home direc- 
tory and subdirectory and <arch> indicates a PC architecture. 
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The value of KmdfLibraryVersion in the INF file must correspond to the ver- 
sion numbers of WdfColnstallerOIxxx.dll and WUDFUpdate_O1xxx.dll. For 
WDK build 6001, which contains WdfColnstaller01007.dll and 
WUDFUpdate_01007.dll, set KmdfLibraryVersion-1.7. 

If using WDK build 6000, make these changes to the example INF file: the 
WudfUpdate and WdfCoinstaller file names are WudfUpdate_01005.dll and 
WafCoinstaller01005.dll, and KmdfLibraryVersion=1.5. Later WDK editions 


may require similar changes to these items. 


Accessing the Device 


VB 


VC# 


Accessing a WinUSB device requires finding the device, initializing communi- 
cations, and exchanging data using bulk, interrupt, and control transfers as 
needed. The WinUSB driver provides Winusb.dll, which exposes WinUSB-spe- 
cific functions that applications can call to obtain access to devices and to con- 
figure, and exchange data with them. 


The code examples in this chapter assume the following Imports and using state- 
ments: 


Imports Microsoft.Win32.SafeHandles 
Imports System.Runtime.InteropServices 


using Microsoft.Win32.SafeHandles; 
using System; 
using System.Runtime.InteropServices; 


Obtaining a WinUSB Handle 
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Before exchanging data with a WinUSB device, an application obtains a device 
pathname using SetupDi_ functions and the device interface GUID from the 
device's INF file. The application can then use CreateFile to obtain a handle. In 
the call to CreateFile, the dwFlagsandAttributes parameter must be set to 
FILE_FLAG_OVERLAPPED. 


Chapter 8 discussed how to generate a GUID. Chapter 10 showed how to 
obtain a handle with CreateFile and use the handle to detect when a device is 
attached and removed. 


After calling CreateFile to obtain a handle, the application calls 
WinUsb_Initialize to obtain a WinUSB interface handle. The application uses 
this handle for all communications with the interface. 


VB 
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Definitions 
Friend Structure devinfo 
Friend deviceHandle As SafeFileHandle 
Friend winUsbHandle As IntPtr 
Friend bulkInPipe As Byte 
Friend bulkOutPipe As Byte 
Friend interruptInPipe As Byte 
Friend interruptOutPipe As Byte 
Friend devicespeed As Ulnt32 
End Structure 


«DIllmport('winusb.dll", SetLastError:=True)> Friend Shared Function WinUsb_Initialize _ 
(ByVal DeviceHandle As SafeFileHandle, _ 
ByRef InterfaceHandle As IntPtr) _ 
As Boolean 

End Function 


Use 
Dim success As Boolean 


Friend myDevinfo As New devInfo 


success = WinUsb_Initialize _ 
(myDevinfo.deviceHandle, _ 
myDevinfo.winUsbHandle) 


Definitions 


internal struct devinfo 
{ 
internal SafeFileHandle deviceHandle; 
internal InPtr winUsbHandle; 
internal Byte bulkInPipe; 
internal Byte bulkOutPipe; 
internal Byte interruptInPipe; 
internal Byte interruptOutPipe; 
internal UInt32 devicespeed; 


[DIlImport(winusb.dll", SetLastError = true)] 
internal static extern Boolean WinUsb Initialize 
(SafeFileHandle DeviceHandle, 
ref IntPtr InterfaceHandle); 
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Use 
Boolean success; 


internal devinfo myDevInfo = new devinfo(); 


success = WinUsb_Initialize 
(myDevinfo.deviceHandle, 
ref myDevinfo.winUsbHandle); 


Details 


The application can create a devInfo structure to hold information about a 
device and its endpoints. The myDevInfo.deviceHandle parameter is the han- 
dle returned by CreateFile. On success, the function returns True and 
myDevInfo.winUsbHandle is a pointer to a WinUSB handle that the applica- 
tion can use to access the device. 


Requesting an Interface Descriptor 


The WinUsb, QueryInterfaceSettings function returns a structure with infor- 
mation about a WinUSB interface. 


VB Definitions 

Friend Structure USB. INTERFACE DESCRIPTOR 
Friend bLength As Byte 
Friend bDescriptorType As Byte 
Friend bInterfaceNumber As Byte 
Friend bAlternateSetting As Byte 
Friend bNumEndpoints As Byte 
Friend bInterfaceClass As Byte 
Friend bInterfaceSubClass As Byte 
Friend bInterfaceProtocol As Byte 
Friend ilnterface As Byte 

End Structure 


«DIlImport("winusb.dll", SetLastError:=True)> _ 
Friend Shared Function WinUsb_QuerylnterfaceSettings _ 
(ByVal InterfaceHandle As IntPtr, _ 
ByVal AlternateInterfaceNumber As Byte, _ 
ByRef UsbAltInterfaceDescriptor As USB. INTERFACE DESCRIPTOR) _ 
As Boolean 
End Function 
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Use 


Dim ifaceDescriptor As USB_INTERFACE_DESCRIPTOR 
Dim success As Boolean 


success = WinUsb_QuerylnterfaceSettings _ 
(myDevinfo.winUsbHandle, _ 
0, — 
ifaceDescriptor) 


Definitions 

internal struct USB INTERFACE DESCRIPTOR 

{ 
internal Byte bLength; 
internal Byte bDescriptorType; 
internal Byte bInterfaceNumber; 
internal Byte bAlternateSetting; 
internal Byte bNumEndpoints; 
internal Byte bInterfaceClass; 
internal Byte bInterfaceSubClass; 
internal Byte bInterfaceProtocol; 
internal Byte ilnterface; 

} 


[Dillmport(‘winusb.dll’, SetLastError = true)] 
internal static extern Boolean WinUsb_QuerylnterfaceSettings 
(IntPtr InterfaceHandle, 
Byte AlternatelnterfaceNumber, 
ref USB INTERFACE DESCRIPTOR UsbAltInterfaceDescriptor); 


Use 


USB INTERFACE DESCRIPTOR ifaceDescriptor; 
Boolean success; 


success = WinUsb QuerylnterfaceSettings 
(myDevInfo.winUsbHandle, 
0, 
ref ifaceDescriptor); 


Details 


The function accepts a pointer to a WinUsb handle and a bAlternateSetting 
number from the interface descriptor to indicate which interface setting to 
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query. On success, the function returns True and a pointer to a 
USB_INTERFACE_DESCRIPTOR structure containing information from 
the requested interface descriptor. 


Identifying the Endpoints 


For each endpoint in the interface descriptor, an application can call 
WinUsb_QueryPipe to learn the endpoint’s transfer type and direction. The 
myDevInfo structure can store the information. 


VB Definitions 


Friend Enum USBD PIPE TYPE 
UsbdPipeTypeControl 
UsbdPipeTypelsochronous 
UsbdPipeTypeBulk 
UsbdPipeTypelnterrupt 

End Enum 


Friend Structure WINUSB PIPE INFORMATION 
Friend PipeType As USBD PIPE TYPE 
Friend Pipeld As Byte 
Friend MaximumPacketSize As UShort 
Friend Interval As Byte 

End Structure 


«DIlImport("winusb.dll", SetLastError:zTrue)» _ 
Friend Shared Function WinUsb QueryPipe _ 
(ByVal InterfaceHandle As IntPtr, _ 
ByVal AlternateInterfaceNumber As Byte, _ 
ByVal Pipelndex As Byte, _ 
ByRef Pipelnformation As WINUSB_PIPE_INFORMATION) _ 
As Boolean 
End Function 
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Use 

The UsbEndpointDirectionIn and UsbEndpointDirectionOut functions 
enable querying the direction of an endpoint: 

Private Function UsbEndpointDirectionIn(ByVal addr As Int32) As Boolean 


If ((addr And &H80) = &H80) Then 
UsbEndpointDirectionIn = True 
Else 
UsbEndpointDirectionIn = False 
End If 


End Function 
Private Function UsbEndpointDirectionOut(ByVal addr As Int32) As Boolean 
If ((addr And &H80) = 0) Then 
UsbEndpointDirectionOut = True 
Else 
UsbEndpointDirectionOut = False 
End If 


End Function 
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The application can request and store information about each of the interface’s 
endpoints in turn. 
For i As Int32 = 0 To ifaceDescriptor.bNumEndpoints - 1 


WinUsb_QueryPipe _ 
(myDevinfo.winUsbHandle, _ 
0,_ 
Convert. ToByte(i) 
pipelnfo) 


If ((pipelnfo.PipeType = _ 
USBD PIPE TYPE.UsbdPipeTypeBulk) And _ 
UsbEndpointDirectionIn(pipelnfo.Pipeld)) Then 
myDeviInfo.bulkInPipe = pipelnfo.Pipeld 


Elself ((pipelnfo.PipeType = _ 
USBD PIPE TYPE.UsbdPipeTypeBulk) And _ 
UsbEndpointDirectionOut(pipelnfo.Pipeld)) Then 
myDevinfo.bulkOutPipe = pipelnfo.Pipeld 


Elself (pipelnfo.PipeType = _ 
USBD_PIPE_TYPE.UsbdPipeTypelnterrupt) And _ 
UsbEndpointDirectionIn(pipelnfo.Pipeld) Then 
myDevlnfo.interruptInPipe = pipelnfo.Pipeld 


Elself (pipelnfo.PipeType = _ 
USBD_PIPE_TYPE.UsbdPipeTypelnterrupt) And _ 
UsbEndpointDirectionOut(pipelnfo.Pipeld) Then 
myDevinfo.interruptOutPipe = pipelnfo.Pipeld 


End If 
Next i 


VC# Definitions 
internal enum USBD_PIPE_TYPE 
{ 
UsbdPipeTypeControl, 
UsbdPipeTypelsochronous, 
UsbdPipeTypeBulk, 
UsbdPipeTypelnterrupt, 
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[StructLayout(LayoutKind.Sequential)] 
internal struct WINUSB PIPE INFORMATION 
{ 
internal USBD_PIPE_TYPE PipeType; 
internal Byte Pipeld; 
internal ushort MaximumPacketSize; 
internal Byte Interval; 
} 


[DIlImport(winusb.dll", SetLastError = true)] 
internal static extern Boolean WinUsb_QueryPipe 
(IntPtr InterfaceHandle, 
Byte AlternatelnterfaceNumber, 
Byte Pipelndex, 
ref WINUSB PIPE INFORMATION Pipelnformation); 


Use 
The UsbEndpointDirectionIn and UsbEndpointDirectionOut functions 
enable querying the direction of an endpoint: 


private Boolean UsbEndpointDirectionIn(Int32 addr) 


{ 
Boolean directionln; 


if (((addr & 0X80) == 0X80)) 
{ directionIn = true; ) 


else 
( directionIn = false; } 
return directionIn; 
Ends Boolean UsbEndpointDirectionOut(Int32 addr) 
i Boolean directionOut; 


if (((addr & 0X80) == 0)) 
{ directionOut = true; } 


else 
{ directionOut = false; } 


return directionOut; 
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The application can request and store information about each of the interface’s 
endpoints in turn. 
for ( Int32 i=0; i <= ifaceDescriptor.DNumEndpoints - 1; i++ ) 


{ 


} 


WinUsb_QueryPipe 
(myDevinfo.winUsbHandle, 
0, 
Convert. ToByte(i), 
ref pipelnfo); 


if (((pipelnfo.PipeType == 
USBD PIPE TYPE.UsbdPipeTypeBulk) && 
UsbEndpointDirectionIn(pipelnfo.Pipeld))) 

{ 
myDeviInfo.bulkInPipe = pipelnfo.Pipeld; 

} 

else if (((pipelnfo.PipeType == 
USBD_PIPE_TYPE.UsbdPipeTypeBulk) && 
UsbEndpointDirectionOut(pipelnfo.Pipeld))) 

{ 
myDeviInfo.bulkOutPipe = pipelnfo.Pipeld; 

} 

else if ((pipelnfo.PipeType == 
USBD_PIPE_TYPE.UsbdPipeTypelnterrupt) && 
UsbEndpointDirectionIn(pipelnfo.Pipeld)) 

{ 
myDevInfo.interruptinPipe = pipelnfo.Pipeld; 

} 

else if ((pipelnfo.PipeType == 
USBD PIPE TYPE.UsbdPipeTypelnterrupt) && 
UsbEndpointDirectionOut(pipelnfo.Pipeld)) 


myDevinfo.interruptOutPipe = pipelnfo.Pipeld; 


Details 

The Pipeld value equals bEndpointAddress in the endpoint descriptor. A valid 
endpoint has a Pipeld greater than zero. The USBD_PIPE_TYPE enumerator 
includes an entry for isochronous pipes, but the WinUSB driver doesn't sup- 
port isochronous transfers. 
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Setting Pipe Policies 


VB 


After identifying an endpoint, an application can set vendor-specific policies for 
transfers at the endpoint. Table 14-1 shows the policies. 


Definitions 

Friend Enum POLICY TYPE As Ulnt32 
SHORT. PACKET. TERMINATE - 1 
AUTO. CLEAR. STALL 
PIPE TRANSFER. TIMEOUT 
IGNORE. SHORT. PACKETS 
ALLOW. PARTIAL READS 
AUTO. FLUSH 
RAW IO 

End Enum 


' Use this definition when the returned Value parameter is a Byte 
' (all except PIPE TRANSFER TIMEOUT): 


«DIlImport("winusb.dll", SetLastError:=True)> _ 
Friend Shared Function WinUsb_SetPipePolicy _ 
(ByVal InterfaceHandle As IntPtr, _ 

ByVal PipelD As Byte, _ 
ByVal PolicyType As Ulnt32, _ 
ByVal ValueLength As Ulnt32, _ 
ByRef Value As Byte) _ 
As Boolean 

End Function 


' Use this alias when the returned Value parameter 
‘is a Ulnt32 (PIPE TRANSFER TIMEOUT only): 


«DIlImport("winusb.dll", EntryPoint:="WinUsb_SetPipePolicy’, SetLastError:=True)> _ 
Friend Shared Function WinUsb_SetPipePolicy1 _ 

(ByVal InterfaceHandle As IntPtr, _ 

ByVal PipelD As Byte, _ 

ByVal PolicyType As Ulnt32, _ 

ByVal ValueLength As UInt32, _ 

ByRef Value As Ulnt32) _ 

As Boolean 
End Function 
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Table 14-1: The WinUsb_SetPipePolicy function can specify how the driver 
responds to various conditions when performing a transfer and whether data 


bypasses WinUSB’s queuing and error handling. 





Parameter 
SHORT PACKET TERMINATE 


Value 
01h 


Default 
False 


Description 


If True, terminate a write transfer 
that is a multiple of wMaxPacketSize 
with a ZLP. 





AUTO CLEAR STALL 


02h 


False 


If True, clear a stall condition 
automatically. 





PIPE TRANSFER TIMEOUT 


IGNORE SHORT PACKETS 


03h 


04h 


Zero 


False 


Set a transfer timeout interval in 
milliseconds. Zero = never time out. 


If True, complete a read operation 
only on receiving the specified 
number of bytes. If False, complete a 
read operation on receiving the 
specified number of bytes or a short 
packet. 





ALLOW_PARTIAL_READS 


05h 


True 


Sets the policy if the endpoint 
returns more data than requested. If 
True, complete the read operation 
and save or discard the extra data as 
specified by AUTO_FLUSH. If 
False, fail the read request. 





AUTO_FLUSH 


06h 


False 


If True and 

ALLOW PARTIAL READS is also 
True, discard extra data. If False and 
ALLOW PARTIAL READS is 
True, save extra data and return it in 
the next read operation. If 

ALLOW PARTIAL READS is 
False, ignore. 





RAW IO 





07h 





False 





Determines whether calls to 
WinUsb_ReadPipe bypasses 
WinUSB's queuing and error 
handling, If True, calls pass directly 
to the USB stack, and the read buffer 
must be a multiple of 
wMaxPacketSize and less than the 
host controller's maximum per 
transfer. If False, calls don't pass 
directly to the USB stack, and the 
buffers don't have the size 
restrictions. 
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Use 
With these overloaded functions, you can call SetPipePolicy to set a policy with 
a Byte or UINT32 value as needed. 
Private Function SetPipePolicy _ 
(ByVal pipeld As Byte, ByVal policyType As UInt32, ByVal value As Byte) _ 
As Boolean 


Dim success As Boolean = WinUsb_SetPipePolicy _ 
(myDevinfo.winUsbHandle, _ 
pipeld, _ 
policyType, _ 
1,_ 
value) 


Return success 
End Function 


Private Function SetPipePolicy _ 
(ByVal pipeld As Byte, ByVal policyType As Ulnt32, ByVal value As Ulnt32) _ 
As Boolean 


Dim success As Boolean = WinUsb_SetPipePolicy1 _ 
(myDevinfo.winUsbHandle, _ 
pipeld, _ 

policyType, _ 

4,_ 
value) 

Return success 


End Function 


Call the functions to set policies for an endpoint: 

Dim success As Boolean 

SetPipePolicy _ 
(myDevinfo.bulkInPipe, _ 
POLICY_TYPE.IGNORE_SHORT_PACKETS, _ 
Convert. ToByte(False)) 


Dim pipeTimeout As Ulnt32 = 2000 
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success = SetPipePolicy _ 
(myDevinfo.bulkInPipe, _ 
POLICY_TYPE.PIPE_TRANSFER_TIMEOUT, _ 
pipeTimeout) 


Definitions 

internal enum POLICY_TYPE 

{ 
SHORT_PACKET_TERMINATE = 1, 
AUTO_CLEAR_STALL, 
PIPE_TRANSFER_TIMEOUT, 
IGNORE_SHORT_PACKETS, 
ALLOW_PARTIAL_READS, 
AUTO_FLUSH, 
RAW 10, 

} 

// Use this definition when the returned Value parameter is a Byte 

// (all except PIPE TRANSFER. TIMEOUT): 


[Dillmport(‘winusb.dll’, SetLastError = true)] 
internal static extern Boolean WinUsb_SetPipePolicy 
(IntPtr InterfaceHandle, 
Byte PipelD, 
Ulnt32 PolicyType, 
Ulnt32 ValueLength, 
ref Byte Value); 


// Use this alias when the returned Value parameter is a UInt32 
// (PIPE TRANSFER TIMEOUT only): 


[DIlImport(winusb.dll", SetLastError = true, EntryPoint = "WinUsb SetPipePolicy")] 
internal static extern Boolean WinUsb_SetPipePolicy1 

(IntPtr InterfaceHandle, 

Byte PipelD, 

Ulnt32 PolicyType, 

Ulnt32 ValueLength, 

ref UInt32 Value); 
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Use 


With these overloaded functions, you can call SetPipePolicy to set a policy with 
a Byte or UINT32 value as needed. 


private Boolean SetPipePolicy( Byte pipeld, UInt32 policyType, Byte value ) 
{ 
Boolean success = WinUsb_SetPipePolicy 
( myDevinfo.winUsbHandle, 
pipeld, 
policyType, 
1 , 
ref value ; 


return success; 
} 


private Boolean SetPipePolicy( Byte pipeld, UInt32 policyType, Ulnt32 value ) 
{ 
Boolean success = WinUsb_SetPipePolicy1 

( myDevinfo.winUsbHandle, 

pipeld, 

policyType, 

4, 

ref value ); 


return success; 
} 


Call the functions to set policies for an endpoint: 
Boolean success; 


success = SetPipePolicy 
( myDevinfo.bulkInPipe, 
Convert. ToUInt32(POLICY TYPE.IGNORE SHORT. PACKETS), 
Convert. ToByte(false)); 


Ulnt32 pipeTimeout = 2000; 
success - SetPipePolicy 
(myDeviInfo.bulkInPipe, 


Convert. ToUInt32(POLICY TYPE.PIPE TRANSFER  TIMEOUT), 
pipeTimeout); 
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Details 


The WinUsb_SetPipePolicy function accepts a Byte for the value parameter for 
all policies except PIPE TRANSFER. TIMEOUT, which requires a UINT32. 
To handle both types, the code provides a definition that accepts a Byte value 
and an alias that accepts a UINT32. Two overloaded SetPipePolicy functions 
accept different value parameter types and pass the parameter to 
WinUsb_SetPipePolicy. 


The Byte parameters have true/false meanings, so for readability, the Set- 
PipePolicy function accepts a Boolean value, and the Convert. ToByte method 
converts to a Byte for passing to WinUsb_SetPipePolicy. 

The example sets two policies for the bulk IN endpoint. In a similar way, you 
can set policies for all of the interface’s endpoints. A companion function for 
reading pipe policies is WinUsb_GetPipePolicy. 


Writing Data via Bulk and Interrupt Transfers 


VB 
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The WinUsb_WritePipe function can write data using bulk or interrupt trans- 
fers. 


Definitions 


«DIlImport("winusb.dll", SetLastError:=True)> _ 
Friend Shared Function WinUsb_WritePipe _ 
(ByVal InterfaceHandle As IntPtr, _ 
ByVal PipelD As Byte, _ 
ByVal Buffer() As Byte, _ 
ByVal BufferLength As UInt32, _ 
ByRef LengthTransferred As Ulnt32, _ 
ByVal Overlapped As IntPtr) _ 
As Boolean 
End Function 


Use 

Dim buffer(1) As Byte 

Dim bytesToWrite As Ulnt32 - 2 
Dim bytesWritten As Ulnt32 
Dim success As Boolean 
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' Place data in the buffer to send. Example: 


buffer(0) = 72 
buffer(1) = 105 
bytesToWrite = Convert.ToUInt32(buffer.Length) 


success = WinUsb WritePipe _ 
(myDevinfo.winUsbHandle, _ 
myDevinfo.bulkOutPipe, _ 
buffer, _ 
bytesToWrite, _ 
bytesWritten, _ 
IntPtr.Zero) 


Definitions 
[Dillmport(‘winusb.dll’, SetLastError = true)] 
internal static extern Boolean WinUsb_WritePipe 
(IntPtr InterfaceHandle, 
Byte PipelD, 
Byte[] Buffer, 
Ulnt32 BufferLength, 
ref UInt32 LengthTransferred, 
IntPtr Overlapped); 


Use 

Byte[] buffer = new Byte[2]; 
Ulnt32 bytesToWrite = 2; 
Ulnt32 bytesWritten = 0; 
Boolean success; 


// Place data in the buffer to send. Example: 
buffer[0] = 72; 
buffer[1] = 105; 


bytesToWrite = Convert. ToUInt32( buffer.Length); 


success - WinUsb WritePipe 
(myDevInfo.winUsbHandle, 
myDevinfo.bulkOutPipe, 
buffer, 
bytesToWrite, 
ref bytesWritten, 
IntPtr.Zero); 
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Details 


The WinUsb_WritePipe function accepts a pointer to a WinUSB handle, an 
endpoint address, a buffer with data to send, and the number of bytes to write. 
On success, the function returns True with the number of bytes written in 
bytes Written. If the function uses overlapped I/O, the Overlapped parameter 
contains a pointer to an OVERLAPPED structure. To send data via an inter- 
rupt transfer, change myDevInfo.bulkOutPipe to myDevInfo.interruptOut- 
Pipe. 

To cause the driver to terminate transfers that are exact multiples of wMaxPack- 
etSize with ZLPs, call WinUsb_SetPipePolicy with 
SHORT_PACKET_TERMINATE = True. This option can be useful if the 
device firmware needs a way to identify the end of a transfer of unknown 


length. 


Reading Data via Bulk and Interrupt Transfers 


VB 
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The WinUsb_ReadPipe function can read data via bulk or interrupt transfers. 


Definitions 

«DIlImport("winusb.dll", SetLastError:=True)> _ 

Friend Shared Function WinUsb_ReadPipe _ 
(ByVal InterfaceHandle As IntPtr, _ 
ByVal PipelD As Byte, _ 
ByVal Buffer() As Byte, _ 
ByVal BufferLength As Ulnt32, _ 
ByRef LengthTransferred As Ulnt32, _ 
ByVal Overlapped As IntPtr) _ 
As Boolean 

End Function 


Use 

Dim buffer(63) As Byte 

Dim bytesRead As UInt32 

Dim bytesToRead As Ulnt32 - 64 
Dim success As Boolean 
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success = WinUsb_ReadPipe _ 
(myDevinfo.winUsbHandle, _ 
myDevinfo.bulkInPipe, _ 
buffer, _ 
bytesToRead, _ 
bytesRead, _ 
IntPtr.Zero) 


Definitions 
[DIlImport(winusb.dll", SetLastError = true)] 
internal static extern Boolean WinUsb_ReadPipe 
(IntPtr InterfaceHandle, 
Byte PipelD, 
Byte[] Buffer, 
Ulnt32 BufferLength, 
ref UInt32 LengthTransferred, 
IntPtr Overlapped); 


Use 

Byte[] buffer = new Byte[ 64 ]; 
Ulnt32 bytesRead = 0; 

Ulnt32 bytesToRead = 64; 
Boolean success - false; 


success - WinUsb ReadPipe 
(myDevInfo.winUsbHandle, 
myDevinfo.bulkInPipe, 
buffer, 
bytesToRead, 
ref bytesRead, 
IntPtr.Zero); 


Details 


The WinUsb_ReadPipe function accepts a pointer to a WinUSB handle, an 
endpoint address, the buffer that will store the received data, and the maximum 
number of bytes to read. On success, the function returns True with the 
received data in the passed buffer and the number of bytes read in bytesRead. If 
the function uses overlapped I/O, the Overlapped parameter contains a pointer 
to an OVERLAPPED structure. To send data via an interrupt transfer, change 
bulkInPipe to interruptInPipe. 


The number of bytes read can depend on the policies set by 
WinUsb SetPipePolicy. 
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Using Vendor-defined Control Transfers 


VB 
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Another option for transferring data is to use vendor-defined requests sent via 
control transfers directed to the interface. 


Definitions 
Friend Structure WINUSB_SETUP_PACKET 
Friend RequestType As Byte 
Friend Request As Byte 
Friend Value As UShort 
Friend Index As UShort 
Friend Length As UShort 
End Structure 


«DIlImport("winusb.dll", SetLastError:=True)> _ 
Friend Shared Function WinUsb_ControlTransfer _ 
(ByVal InterfaceHandle As IntPtr, _ 
ByVal SetupPacket As WINUSB_SETUP_PACKET, _ 
ByVal Buffer() As Byte, _ 
ByVal BufferLength As UInt32, _ 
ByRef LengthTransferred As UInt32, _ 
ByVal Overlapped As IntPtr) _ 
As Boolean 
End Function 


Use 
Dim bytesReturned As UInt32 


Dim dataStage(1) As Byte 

Dim setupPacket As WINUSB_SETUP_PACKET 

Dim success As Boolean 

' Use this for a vendor-specific request to an interface with a device-to-host Data stage. 
' setupPacket.RequestType = &HC1 

' Use this for a vendor-specific request to an interface with host-to-device Data stage: 
setupPacket.RequestType = &H41 


' The number that identifies the specific request. 


setupPacket.Request - 1 
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' Vendor-defined values to send to the device. 


setupPacket.Index = 2 
setupPacket.Value = 3 


' For control Write transfers (host-to-device Data stage), provide data for the Data stage. 
' Example: 


dataStage(0) - 65 
dataStage(1) - 66 


' The number of bytes in the request's Data stage. 
setupPacket.Length = Convert.ToUInt16(dataStage.Length) 


success = WinUsb_ControlTransfer _ 
(myDevinfo.winUsbHandle, _ 
setupPacket, _ 
dataStage, _ 
setupPacket.Length, _ 
bytesReturned, _ 
IntPtr.Zero) 


Definitions 
internal struct WINUSB_SETUP_PACKET 
{ 
internal Byte RequestT ype; 
internal Byte Request; 
internal ushort Value; 
internal ushort Index; 
internal ushort Length; 
} 


[Dillmport(‘winusb.dll’, SetLastError = true)] 

internal static extern Boolean WinUsb ControlTransfer 
(IntPtr InterfaceHandle, 
WINUSB_SETUP_PACKET SetupPacket, 
Byte[] Buffer, 
Ulnt32 BufferLength, 
ref UInt32 LengthTransferred, 
IntPtr Overlapped); 
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Use 
Ulnt32 bytesReturned = 0; 


Byte[] dataStage = new Bytel 2 ]; 

WINUSB_SETUP_PACKET setupPacket; 

Boolean success; 

// Use this for a vendor-specific request to an interface with a device-to-host Data stage. 
// setupPacket.RequestType = OXC1; 

// Use this for a vendor-specific request to an interface with host-to-device Data stage. 
setupPacket.RequestType = 0X41; 

// The request number that identifies the specific request. 

setupPacket.Request = 1; 


// Vendor-specific values to send to the device. 


setupPacket.Index = 2; 
setupPacket.Value - 3; 


// For control Write transfers (host-to-device Data stage), provide data for the Data stage. 
// Example: 


dataStage[0] = 65; 
dataStage[1] = 66; 


// The number of bytes in the request's Data stage. 
setupPacket.Length = Convert.ToUInt16( dataStage.Length ); 


success = WinUsb_ControlTransfer 
(myDevinfo.winUsbHandle, 
setupPacket, 
dataStage, 
setupPacket.Length, 
ref bytesReturned, 
IntPtr.Zero); 


Using WinUSB for Vendor-Defined Functions 


Details 


The WINUSB_SETUP_PACKET structure holds the contents of the fields in 
the Setup stage’s data packet as described in Chapter 2. The application sets 
Request Type to the bmRequest Type value for a vendor-specific request directed 
to an interface with bit 7 indicating the direction of the Data stage. The 
Request, Value, and Index fields are the desired values for bRequest, wValue, 
and wIndex in the request. 


For a control write request, the application places the data to send to the device 
in an array. For a control read request, the application provides an array to hold 
data received from the device. 


The WinUsb_ControlTransfer function initiates a control transfer. The func- 
tion passes a pointer to a WinUSB handle to the interface, a 
WINUSB_SETUP_PACKET structure, a byte array that contains data to send 
or space for received data, and the number of bytes to read or write. On success, 
the function returns True with the number of bytes read or written in the 
LengthTransferred parameter. 


Closing Communications 


VB 


VC# 


When finished communicating with a device, the application should free 
reserved resources. 


Definitions 

<DIlImport(‘winusb.dll', SetLastError:=True)> Friend Shared Function WinUsb_Free _ 
(ByVal InterfaceHandle As IntPtr) _ 
As Boolean 
End Function 


Use 


WinUsb_Free(myDevInfo.winUsbHandle) 
myDevinfo.deviceHandle.Close() 


Definitions 


[DIlImport(winusb.dll", SetLastError = true)] 
internal static extern Boolean WinUsb_Free 
(IntPtr InterfaceHandle); 


Use 
WinUsb Free(myDevInfo.winUsbHandle); 
myDevinfo.deviceHandle.Close(); 
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Details 
WinUsb_Free frees the resources allocated by WinUsb_Initialize, and the Close 
method marks the SafeFileHandle obtained with CreateFile for releasing and 


freeing. 
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All About Hubs 


A hub is an intelligent device that provides attachment points for devices and 
manages each devices connection to the bus. Devices that plug directly into the 
host computer connect to the system’s root hub. Other devices can connect to 
external hubs downstream from the root hub. 


A hub manages power use, helps initiate communications with newly attached 
devices, and passes traffic up and down the bus. To manage power, a hub pro- 
vides current to attached devices and limits current on detecting an over-cur- 
rent condition. To help initiate communications with devices, the hub detects 
and informs the host of newly attached devices and carries out requests that 
apply to the devices’ ports. The hub’s role in passing traffic up and down the 
bus varies with the speeds of the host, device, and hubs between them. 

This chapter presents essentials about hub communications. You dont need to 
know every detail about hubs in order to design a USB peripheral. But some 
understanding of what the hub does can help in understanding how devices are 
detected and communicate on the bus. 
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Figure 15-1. This hub has an upstream-facing port with a Standard-B receptacle 
(left), four downstream-facing ports with Standard-A receptacles (center), and 
a power connection (right). 


USB 2.0 
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Each external USB 2.0 hub has one port, or attachment point, that connects in 
the upstream direction (toward the host) (Figure 15-1). This upstream-facing 
port may connect directly to the host’s root hub, or the port may connect to a 
downstream-facing port on another external hub. Each hub has one or more 
downstream-facing ports. Most downstream ports have a receptacle for attach- 
ing a cable. An exception is hubs in compound devices, whose downstream-fac- 
ing ports connect to functions embedded in the device. Hubs with one, two, 
four, and seven downstream ports are common. A hub may be self powered or 
bus powered. As Chapter 16 explains, bus-powered hubs are limited because 
you cant attach high-power devices to them. 


A USB 2.0 hub acts as a remote processor with store-and-forward capabilities. 
The hub converts between high-speed upstream communications and low- and 
full-speed downstream communications as needed and performs other func- 
tions that help make efficient use of bus time. In contrast, a USB 1.x hub 
doesn’t convert between speeds; it just passes received traffic up or down the 
bus. For traffic to and from low-speed devices, a USB 1.x hub changes the edge 
rate and signal polarity but not the bit rate. The added intelligence of USB 2.0 
hubs is a major reason why the high-speed bus remains compatible with USB 
1.x devices. 

Controller chips for hubs contain dedicated silicon to perform hub functions. 
Due to timing requirements, implementing a hub function with a general-pur- 
pose device controller chip isn't feasible. For single-chip compound devices, 
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Figure 15-2. A USB 2.0 hub contains one or more transaction translators and 
routing logic that enable a hub on a high-speed bus to communicate with low- 
and full-speed devices. A USB 1.x hub doesn't convert between bus speeds. 
(Adapted from Universal Serial Bus Specification Revision 2.0.) 






































USB 2.0 HUB 


chips that contain an embedded hub and a generic device controller are avail- 


able. 


An external USB 2.0 hub contains a hub repeater and a hub controller (Figure 
15-2). The hub repeater passes USB traffic between the upstream hub (which 
may be on the host) and attached and enabled downstream devices. The hub 
controller manages communications between the host and the hub repeater. 
State machines control the hub's response to events at the hub repeater and 
upstream and downstream ports. A USB 2.0 hub also has one or more transac- 


375 


Chapter 15 


tion translators and routing logic that enable low- and full-speed devices to 
communicate on a high-speed bus. 

The host’s root hub is a special case. The host controller performs many of the 
functions that the hub repeater and hub controller perform in an external hub, 
so a root hub may contain little more than routing logic and downstream ports. 


The Hub Repeater 
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The hub repeater re-transmits the packets it receives, sending them on their way 
up or down stream with minimal changes. The hub repeater also detects when a 
device is attached and removed, establishes the connection of a device to the 
bus, detects bus faults such as over-current conditions, and manages power to 
the device. 


A USB 2.0 hub repeater has two modes of operation depending on the 
upstream bus speed. When the hub connects upstream to a full-speed bus seg- 
ment, the repeater functions as a low- and full-speed repeater. When the hub 
connects upstream to a high-speed bus segment, the repeater functions as a 
high-speed repeater. The repeaters in USB 1.x hubs always function as low- and 
full-speed repeaters. 


The Low- and Full-speed Repeater 


The hub repeater in a USB 1.x hub handles low- and full-speed traffic. A USB 
2.0 hub also uses this type of repeater when its upstream port connects to a 
full-speed bus. In this case, the USB 2.0 hub doesn’t send or receive high-speed 
traffic but instead functions identically to a USB 1.x hub. 


A low- and full-speed repeater re-transmits all low- and full-speed packets 
received from the host, including data that has passed through one or more 
additional hubs, to all enabled, full-speed, downstream ports. Enabled ports 
include all ports with attached devices that are ready to receive communications 
from the hub. Devices with ports that arent enabled include devices that the 
host controller has stopped communicating with due to errors or other prob- 
lems, devices in the Suspend state, and devices that aren't yet ready to commu- 
nicate because they have just been attached or are in the process of exiting the 
Suspend state. 

The hub repeater doesnt translate, examine the contents of, or process the traf- 
fic to or from full-speed ports. The repeater just regenerates the edges of the sig- 
nal transitions and passes the traffic on. 
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Low-speed devices never see full-speed traffic. A USB 1.x hub repeats only 
low-speed packets to low-speed devices. The hub identifies a low-speed packet 
by the PRE packet identifier that precedes the packet. The hub repeats the 
low-speed packets, and only these packets, to any enabled low-speed ports. The 
hub also repeats low-speed packets to its full-speed downstream ports because a 
full-speed port may connect to a hub that in turn connects to a low-speed 
device. To give hubs time to make their low-speed ports ready to receive data, 
the host adds a delay of at least four full-speed bit widths between the PRE 
packet and the low-speed packet. 


Compared to full speed, traffic in a low-speed cable segment varies not only in 
speed, but also in edge rate and polarity. A hub whose downstream port con- 
nects directly to a low-speed device uses low speed’s edge rate and polarity when 
communicating with the device. When communicating upstream, the hub uses 
full-speed’s faster edge rate and an inverted polarity compared to low speed. 
The hub repeater converts between the edge rates and polarities as needed. 
Chapter 18 has more on the signal polarities, and Chapter 19 has more about 
edge rates. 


The High-speed Repeater 


A USB 2.0 hub uses a high-speed repeater when the hub’s upstream port con- 
nects to a high-speed bus segment. In this case, the hub sends and receives all 
upstream traffic at high speed even if the traffic is to or from a low- or 
full-speed device. Routing logic in the hub determines whether traffic to or 
from a downstream port passes through a transaction translator. 


Unlike a low- and full-speed repeater, a high-speed repeater re-clocks received 
data to minimize accumulated jitter. In other words, instead of just repeating 
received transitions, a high-speed repeater uses its own local clock to time the 
transitions when retransmitting. The edge rate and polarity don’t change. An 
elasticity buffer allows for small differences between the hub’s clock frequency 
and the timing of the received data. When the buffer is half full, the received 
data begins clocking out. 


The Transaction Translator 


Every USB 2.0 hub must have a transaction translator to manage communica- 
tions with low- and full-speed devices. The transaction translator communi- 
cates upstream at high speed while enabling low- and full-speed devices to 
continue to communicate at low and full speeds. The transaction translator 
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Figure 15-3. A transaction translator contains a high-speed handler for 
upstream traffic, buffers for storing information in split transactions, and a low- 
and full-speed handler for downstream traffic to low- and full-speed devices. 
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stores received data and forwards, or transmits, the data toward its destination 
at the appropriate speed. 


The transaction translator frees bus time by enabling other communications to 
use the bus while a hub completes a low- or full-speed transaction with a device. 
Transaction translators can also enable low- and full-speed devices to have more 
bandwidth than the host could allocate on a shared low/full-speed bus. 


For traffic to and from low- and full-speed devices, the high-speed repeater 
communicates with the transaction translator, which manages transactions with 
the devices. 


Sections 


The transaction translator contains three sections (Figure 15-3). The 
high-speed handler communicates with the host at high speed. The 
low/full-speed handler communicates with devices at low and full speeds. Buff- 
ers store data used in transactions with low- and full-speed devices. Each trans- 
action translator has to have at least four buffers: one for interrupt and 
isochronous start-split transactions, one for interrupt and isochronous com- 
plete-split transactions, and two or more for control and bulk transfers. 
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3. THE HOST INITIATES AND COMPLETES THE COMPLETE-SPLIT TRANSACTION WITH THE HUB. 


Figure 15-4. In a transfer that uses split transactions, the host communicates at 
high speed with a USB 2.0 hub, and the hub communicates at low or full speed 
with the device. Isochronous transactions may use multiple start-split or 


complete-split transactions. 


Managing Split Transactions 


When a USB 2.0 host wants to communicate with a low- or full-speed device 
that connects to a hub on a high-speed bus, the host initiates a split transaction 
with the USB 2.0 hub that is nearest the device and communicating upstream 
at high speed. Figure 15-4 shows the transactions that make up a split transac- 
tion. 


One or more start-split transactions contain the information the hub needs to 
complete the transaction with the device. The transaction translator stores the 
information received from the host and completes the start-split transaction 
with the host. 


On completing a start-split transaction, the hub performs the function of a host 
controller in carrying out the transaction with the device. The transaction 
translator initiates the transaction in the token phase, sends data or stores 
returned data or status information as needed in the data phase, and sends or 
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receives a status code as needed in the handshake phase. The hub uses low or 
full speed as needed in its communications with the device. 


After the hub has had time to exchange data with the device, in all transactions 
except isochronous OUTS, the host initiates one or more complete-split trans- 
actions to retrieve the information returned by the device and stored in the 
transaction translator's buffer. The hub performs these transactions at high 
speed. 


Table 15-1 compares the structure and contents of transactions with low- and 
full-speed devices at different bus speeds. 


Bulk and control transfers don’t have the timing constraints of interrupt and 
isochronous transfers and thus use a simpler protocol. In the start-split transac- 
tion, the USB 2.0 host sends the start-split token packet (SSPLIT), followed by 
the usual low- or full-speed token packet and any data packet destined for the 
device. The USB 2.0 hub that is nearest the device and communicating 
upstream at high speed returns ACK or NAK. The host is then free to use the 
bus for other transactions. The device knows nothing about the transaction yet. 


On returning ACK in a start-split transaction, the hub has two responsibilities. 
The hub must complete the transaction with the device and must continue to 
handle any other bus traffic received from the host or other attached devices. 


To complete the transaction, the hub converts the packet or packets received 
from the host to the appropriate speed, sends them to the device and stores the 
data or handshake returned by the device. Depending on the transaction, the 
device may return data, a handshake, or nothing. For IN transactions, the hub 
returns a handshake packet to the device. To the device, the transaction has pro- 
ceeded at the expected low or full speed and is now complete. The device has no 
knowledge that the transaction is a split transaction. The host hasn't yet 
received the devices response. 


While the hub is completing the transaction with the device, the host may ini- 
tiate other bus traffic that the devices hub must handle as well. Separate hard- 
ware modules within the hub handle the two functions. When the hub has had 
enough time to complete the transaction with the device, the host begins a 
complete-split transaction with the hub. 


In a complete-split transaction, the host sends a complete-split token packet 
(CSPLIT), followed by a low- or full-speed token packet to request the data or 
status information the hub has received from the device. The hub returns the 
information. The transfer is now complete at the host. The host doesn’t return 
an ACK to the hub. If the hub doesnt have the packet ready to send, the hub 
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Table 15-1: When a low- or full-speed device has a transaction on a high-speed 
bus, the host uses start-split (SSPLIT) and complete-split (CSPLIT) transactions 
with the USB 2.0 hub nearest the device and communicating upstream at high 
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Low/Full-speed — |Setup, OUT PRE iflow speed, |PRE iflow speed, |status (except for 
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returns NYET, and the host retries later. The device is unaware of the com- 
plete-split transaction. 


In split transactions in interrupt and isochronous transfers, the process is simi- 
lar but with stricter timing. The goals are to transfer data to the host as soon as 
possible after the device has data available to send and to transfer data to the 
device just as the device is ready to receive new data. To achieve this timing, iso- 
chronous transactions with large packets use multiple start splits or complete 
splits and transfer a portion of the data in each. 


Unlike with bulk and control transfers, start-split transactions in interrupt and 
isochronous transfers have no handshake phase, just the start-split token fol- 
lowed by an IN, OUT, or Setup token and OUT or Setup transactions, data. 


In an interrupt transaction, the hub schedules the start split in the microframe 
just before the earliest time that the hub is expected to begin the transaction 
with the device. For example, assume that the microframes in a frame are num- 
bered in sequence, 0—7. If the start split is in microframe 0, the transaction with 
the device can occur as early as microframe 1. The device may have data or a 
handshake response to return to the host as early as microframe 2, and the host 
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schedules time for three complete-split transactions in microframes 2, 3, and 4. 
If the hub doesn’t yet have the information to return in a complete split, the 
hub returns NYET and the host retries. 


Full-speed isochronous transactions can transfer up to 1023 bytes. To ensure 
that the data transfers as soon as the device has data to send or is ready to 
receive data, transactions with large packets use multiple start splits or complete 
splits with up to 188 data bytes in each. This amount is the maximum quantity 
of full-speed data that fits in a microframe. A single transaction’s data can 
require up to eight start-split or complete-split transactions. 


In an isochronous IN transaction, the host schedules complete-split transac- 
tions in every microframe where the host expects the device to have at least a 
portion of the data to return. Requesting the data in smaller chunks ensures 
that the host receives the data as quickly as possible. The host doesn’t have to 
wait for all of the data to transfer from the device at full speed before beginning 
to retrieve the data. 


In an isochronous OUT transaction, the host sends the data in one or more 
start-split transactions. The host schedules the transactions so the hub’s buffer 
will never be empty but will contain as few bytes as possible. Each SPLIT 
packet contains bits that indicate the data’s position in the low- or full-speed 
data packet (beginning, middle, end, or all). There is no complete-split transac- 
tion. 


Bandwidth Use of Low- and Full-speed Devices 


Because a USB 2.0 hub acts as a host controller in managing transactions, low- 
and full-speed devices share low/full-speed bandwidth only with devices that 
use the same transaction translator. Most hubs provide one transaction transla- 
tor for all ports, but a single hub can provide a transaction translator for each 
port that connects to a low- or full-speed device. 


If two full-speed devices each have a dedicated transaction translator on a 
high-speed bus, each device can use all of the transaction translator’s down- 
stream, full-speed bandwidth. When the hub(s) convert to high speed, the 
full-speed traffic uses little of the high-speed bandwidth. 


For bulk transactions, the extra transaction with the host in each split transac- 
tion can result in lower throughput for a full-speed device that connects to a 
hub on a busy bus that is also carrying high-speed bulk traffic. 
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The Hub Controller 


A USB 2.0 hub controller manages communications between the host and the 
hub. As it does for all devices, the host enumerates a newly detected hub to 
learn about it. The hub descriptor retrieved during enumeration tells the host 
the number of ports on the hub. After enumerating the hub, the host requests 
the hub to report whether the hub has any attached devices. If so, the host enu- 
merates these as well. 


The host finds out if a device is attached to a port by sending the hub-class 
request Get Port Status. This is similar to a Get Status request but is directed to 
a hub and has a port number in the wIndex field. The hub returns two 16-bit 
values that indicate whether a device is attached and other information such as 
whether the device is in the Suspend state. 


The hub controller is also responsible for disabling any port that was responsi- 
ble for loss of bus activity or babble. Loss of bus activity occurs when a packet 
doesnt end with the expected EOP. Babble occurs when a device continues to 
transmit beyond the EOP. 


Each hub has a Status Change endpoint configured for interrupt IN transfers. A 
USB 2.0 host polls the endpoint to find out if the hub has any changes to 
report. On each poll, the hub controller returns NAK if there have been no 
changes or data that indicates a specific port or the hub itself as the source of 
the change. After a reported change, the host sends requests to find out more 
about the change and take whatever action is needed. For example, if the hub 
reports attachment of a new device, the host attempts to enumerate the device. 


Speed 
An external USB 2.0 hub’s downstream ports must support low, full, and high 
speeds. In the upstream direction, if a USB 2.0 hub’s upstream segment is high 
speed, the hub communicates at high speed. Otherwise, the hub communicates 
upstream at low and full speeds. 


A USB 1.x hub’s upstream port must support low- and full-speed communica- 
tions. All downstream ports with connectors must support both low- and 
full-speed communications. USB 1.x hubs never support high speed. 


Filtering Traffic according to Speed 


Low-speed devices aren't capable of receiving full-speed data so hubs don't 
repeat full-speed traffic to low-speed devices. Otherwise, a low-speed device 
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Figure 15-5. The device’s port has a stronger pull-up than the hub’s. The location 
of the pull-up tells the hub whether the device is low or full speed. High-speed 
devices are full speed at attachment. 
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would try to interpret full-speed traffic as low-speed data and might even mis- 
takenly see what looks like valid data. Full- or high-speed data on a low-speed 
cable could also cause problems due to radiated electromagnetic interference 
(EMI). In the other direction, hubs repeat received low-speed data upstream. 


Low- and full-speed devices aren't capable of receiving high-speed data, so USB 
2.0 hubs don’t repeat high-speed traffic to these devices, including USB 1.x 
hubs. 


Detecting Device Speed 


On attachment, every USB 2.0 device must support either low or full speed. A 
hub detects whether an attached device is low or full speed by detecting which 
signal line is more positive on an idle line. Figure 15-5 illustrates. As Chapter 4 
explained, the hub has pull-down resistors of 14.25k-24.8kO on D+ and D-. A 
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newly attached device has a pull-up of 900—1575Q on either D+ for a full-speed 
device or D- for a low-speed device. When a device attaches to a port, the line 
with the pull-up is more positive than the hubs logic-high input threshold. The 
hub detects the voltage, assumes a device is attached, and determines the speed 
by detecting which line is pulled up. 


After detecting a full-speed device, a USB 2.0 hub determines whether the 
device supports high speed by using the high-speed detection handshake. The 
handshake occurs during the Reset state that the hub initiates during enumera- 
tion. If the handshake succeeds, the device removes its pull-up and communica- 
tions are at high speed. A USB 1.x hub ignores the attempt to handshake, and 
the failure of the handshake informs the device that it must use full speed. 
Chapter 18 has more details about the handshake. 


Maintaining Active Links 


SOF packets keep full- and high-speed devices from entering the Suspend state 
on an otherwise idle bus. On an idle, full-speed bus, the host continues to send 
an SOF once per frame, and hubs pass these packets on to their full-speed 
devices. On an otherwise idle, high-speed bus, the host continues to send an 
SOF once per microframe, and hubs pass these packets on to their high-speed 
devices. A full-speed device that connects to a USB 2.0 hub that communicates 
upstream at high speed will also receive an SOF once per frame from the hub. 


Low-speed devices don't see the SOFs. Instead, at least once per frame, hubs 
must send their low-speed devices a low-speed End-of-Packet (EOP) signal 
(defined in Chapter 18). This signal functions as a keep-alive signal that keeps a 
device from entering the Suspend state on a bus with no low-speed activity. A 
host can also request a hub to suspend the bus at a single port. Chapter 16 has 
more on how hubs manage the Suspend state. 


USB 3.0 


A USB 3.0 hub contains both a USB 2.0 hub that supports low, full, and high 
speeds and a SuperSpeed hub (Figure 15-6). The hubs operate independently 
except for sharing logic to control VBUS. The host enumerates a USB 3.0 hub 
as two devices. Hubs are the only devices with ports that can communicate 
upstream at the same time at both SuperSpeed and high speed. 
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Figure 15-6. A USB 3.0 hub contains a USB 2.0 hub and a hub for SuperSpeed. 
(Adapted from Universal Serial Bus 3.0 Specification.) 


Bus Speeds 


The speed of a hub’s upstream port determines what bus speeds are available to 
downstream ports. If the upstream port connects at SuperSpeed, the hub can 
communicate with downstream devices at any speed. If the upstream port con- 
nects at high speed, the hub can communicate downstream at low, full, and 
high speeds. If a USB 3.0 hub’s upstream port connects at full speed, the hub 
can communicate downstream at low and full speeds. A downstream-facing 
port that connects internally to an embedded device can support a single speed. 
At the hub’s upstream port, traffic to and from downstream SuperSpeed devices 
uses the SuperSpeed wires, and traffic to and from downstream low-, full-, and 
high-speed devices uses the USB 2.0 wires. As with USB 2.0 hubs, all upstream 
traffic on the USB 2.0 wires uses high speed (unless a USB 1.x hub is upstream 
from the hub). 


Components 


The SuperSpeed portion of a USB 3.0 hub consists of a repeater/forwarder and 
a hub controller. Like the hub repeater in a USB 2.0 hub, the repeater/for- 
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warder re-transmits received packets, detects device attachment and removal, 
establishes the connection of a device to the bus, detects bus faults such as 
over-current conditions, and manages power to the device. A hub may partially 
store a Data Packet before beginning to forward it, and the hub stores and for- 
wards all other packets. Buffers help to manage the traffic that passes through 
the hub. Buffers enable storing packet headers for later delivery to a down- 
stream device that must exit a low-power mode before receiving traffic. Buffers 
also enable receiving asynchronous messages from multiple downstream devices 
at once and holding received payload data to repeat. To enable retrying, after 
transmitting a Data Packet, the buffer retains the packet until receiving a 
link-level acknowledgement. 


As in a USB 2.0 hub, a USB 3.0 hub controller manages communications 
between the host and the hub. The hub sends status information via an inter- 
rupt IN Status Change endpoint. A hub with information to report sends an 
ERDY Transaction Packet to the host. 


Managing Traffic 


The hub stores and forwards header packets and repeats Data Packets. The hub 
must be able to store eight header packets directed to the same downstream 
port and eight header packets received at a downstream port. 


During hub enumeration, the host sends a Set Hub Depth request to assign a 
hub-depth value to the hub. The value equals the number of additional 
upstream hubs that lie in the path between the hub and the root hub. Hubs that 
connect directly to the root hub have a hub depth of zero. Any hubs that con- 
nect to downstream ports on those hubs have a hub depth of one. Any hubs 
that connect to those hubs have a hub depth of two, and so on up to a maxi- 
mum hub depth of four. The USB 2.0 specification defines the root hub as tier 
1 in the bus topology, so hub depth equals the hubs tier - 2. 


Unlike USB 2.0 hubs, USB 3.0 hubs don’t broadcast downstream traffic but 
instead direct traffic only toward the target device. Using routing instead of 
broadcasting enables ports to enter a low-power state when not communicating 
with the host even if the bus is carrying traffic to other device. In the upstream 
direction, hubs route all traffic to the host as with USB 2.0. On receiving a 
packet from the host, a hub uses its hub-depth value and a Route String in the 
packet header to determine whether the hub should process the packet or route 
the packet to a downstream port. The Route String has five 4-bit fields. Each 
field contains information that applies to one of up to five external hubs in the 
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path that the packet travels. The hub-depth value identifies which 4-bit field in 
a received Route String applies to the hub. The field contains either a port 
number to route the packet to or zero if the packet’s destination is the hub itself. 
Because the Route String’s fields are four bits, a USB 3.0 hub can have at most 
15 downstream ports. A hub that isn’t configured assumes all packets are 
directed to itself. 


The Hub Class 


Hub 


Hub 


Hubs are members of the hub class, which is the only class defined in the main 
USB specification. 


Descriptors 


The hub descriptor informs the host of hub-specific capabilities such as sup- 
ported modes for power switching and overcurrent protection. For USB 3.0 
hubs, the hub descriptor has additional fields to support USB 3.0 capabilities. 
A host can request the descriptor with a Get Hub Descriptor control request. A 
USB 3.0 hub must have a device capability descriptor with a Container ID that 
identifies the device instance. The Container ID is the same value for the USB 
2.0 and USB 3.0 hub functions in a device. 


Class Requests 


A host can use hub-class requests to obtain status information, set and clear hub 
and port features, and monitor and control transaction translators. 


Port Indicators 
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The USB 2.0 specification defines optional indicators to indicate port status to 
the user. The specification assigns standard meanings to the colors and blinking 
properties of status LEDs or similar indicators. Each downstream port on a hub 
can have an indicator, which can be a single bi-color green/amber LED or a sep- 
arate LED for each color: 


Green fully operational 

Amber error condition 

Blinking off/green software attention required 
Blinking off/amber hardware attention required 
Off not operational 
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A convenient feature of USB is the ability to draw power from the bus. But 
using bus power carries the responsibility to operate within allowed limits, 
including reducing power in the Suspend state. 


This chapter will help you decide if a device can use bus power. Plus, whether 
your design is bus-powered or self-powered, you'll find out how to ensure that 
your device follows the USB specification’s requirements for managing power. 
Also covered are new power-saving options for USB 2.0 and USB 3.0. 


Power Options 


Inside a typical PC is a power supply with amperes to spare. Many hubs also 
have their own power supplies. Some USB devices can take advantage of these 
existing supplies rather than providing their own power sources. 


Bus power has several advantages. Users don't need an electrical outlet near the 
device. A device with no internal power supply can be physically smaller, lighter 
in weight, and less expensive to manufacture. The device can save energy 
because power supplies in PCs use efficient switching regulators rather than the 
cheap linear regulators in the power adapters that many peripherals use. 
(Self-powered hubs may use inefficient supplies, however.) 
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Voltages 


The nominal voltage between the VBUS and GND wires in a USB cable is 5V, 
but the actual value can vary. VBUS at a host or hub’s downstream port can be 
anywhere in the range 4.45—5.25V. Cable and connector losses further reduce 
the voltage available at a devices port. 

These are the minimum and maximum valid voltages for connectors on down- 
stream-facing ports: 














Hub Type USB Available Current |VBUS at Hub Port (V) 
Version per Port (mA) Minimum Maximum 
High Power USB 2.0 500 4.75 5.25 
USB 3.0 900 4.45 5.25 
Low Power USB 2.0 100 4.4 5.25 
USB 3.0 150 4.45 5.25 














High-power USB 2.0 devices must at minimum respond to enumeration 
requests with at least 4.4V on the B connector. All USB 3.0 devices must at 
minimum respond to enumeration requests with at least 4.0V on the B connec- 
tor. Transient conditions can cause the voltage to drop briefly by a few addi- 
tional tenths of a volt. 

USB controller chips typically use a 45V or +3.3V supply. Devices powered at 
3.3V can use an inexpensive low-dropout linear regulator to obtain 3.3V from 
VBUS. If a component needs a higher voltage, the device can contain a step-up 
switching regulator. 


Using Bus Power 
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Figure 16-1 will help you decide whether a specific device can use bus power. 
Advances in semiconductor technology have reduced the power required by 
many circuits. Thanks to CMOS manufacturing processes, lower supply volt- 
ages for components, and power-conserving modes in CPUs, you can do a lot 
with 100 mA. 


A device that requires up to 100 mA can be bus powered from any host or hub. 
A device that requires up to 500 mA can use bus power when attached to a 
self-powered hub or any host except some battery-powered hosts. A SuperSpeed 
device on a USB 3.0 bus can draw up to 150 mA from any USB 3.0 hub and 


up to 900 mA when attached to any host except some battery-powered hosts. 


Managing Power 


Does the device need to function 
when not attached to the bus? 


No Yes 


I> Self power 


required 











Does the device require more than 
500 mA (USB 2.0) or 900 mA (Superspeed)? 











No Yes 
Self power 


/ required 


Can the device limit its current to 
2.5 MA when in the Suspend state? 





Self power 
/ required 





Does the device require more than 
100 mA (USB 2.0) or 150 mA (SuperSpeed)? 











No Yes 





Bus power OK 
Does the device need to be able to 


operate from all battery-powered 
computers and bus-powered hubs? 














No Yes 
NA 
Bus power OK Self power required 


Figure 16-1. Some devices can draw all of their power from the bus. 
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No device should draw more than 100 mA (USB 2.0) or 150 mA (SuperSpeed) 
until the host has configured the device for more current. Devices must limit 
their power consumption further when in the Suspend state. In some cases, bat- 
tery charging can exceed these limits as described later in this chapter. 


Of course, devices such as digital cameras that need to function when not 
attached to a host will need self power. Self power can use batteries or power 
from a wall socket. To save battery power, a device can use bus power when 
connected to the bus and self power otherwise. Because a device in the Suspend 
state should draw very little current from the bus, some devices need their own 
supplies to enable operating when the bus is suspended. 


Power Needs 
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USB 2.0 defines a low-power device as a bus-powered device that draws up to 
100 mA from the bus and a high-power device as a device that draws up to 500 
mA from the bus. A self-powered device can draw up to 100 mA from the bus 
and as much power as is available from the device’s supply. 


A high-power device must be able to enumerate at low power. On power-up, a 
USB 2.0 device can draw up to 100 mA from the bus until the host has config- 
ured the device. After retrieving a configuration descriptor, the host examines 
the amount of current requested in bMaxPower, and if the current is available, 
the host sends a Set Configuration request to select the configuration. The 
device can then draw up to the bMaxPower value from the bus. In reality, hosts 
and hubs are likely to allocate either 100 mA or 500 mA to a device rather than 
a precise amount requested in bMaxPower. 


A self-powered USB 2.0 device may also draw up to 100 mA from the bus any 
time the device isn't in the Suspend state. This capability enables the device's 
USB interface to function when the devices power supply is off and the host 
detects and enumerates the device. Otherwise, if a devices pull-up is bus-pow- 
ered and the rest of the interface is self-powered, the host will detect the device 
but wont be able to communicate with it. 


The limits are absolute maximums, not averages. Also remember that the bus’s 
power-supply voltage can be as high as 5.25V, and a higher voltage can result in 
greater current consumption. 


A device must never provide upstream power. Even the pull-up must remain 
unpowered until VBUS is present. A device that provides upstream power can 
cause problems that include a PC that doesn’t boot or doesn't resume from the 
Suspend state, a hub that doesn't enumerate its downstream devices, and failure 
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of an upstream device. A self-powered device must connect to VBUS to detect 
its presence even if the device never uses bus power. USB compliance testing 
includes a back-voltage test to verify that a device doesn't provide upstream 
power. The test, described in the compliance test documentation, requires just 
three resistors and a voltmeter. 


Hosts in embedded systems may turn off VBUS to save power but may still 
need the ability to detect device attachment even when VBUS is off. The Device 
Capacitance ECN to the USB 2.0 specification enables device detection by 
ensuring a change in capacitance on VBUS on device attachment. The ECN 
mandates a capacitance of 1-10 uF between VBUS and GND on a device's 
upstream-facing port. 


SuperSpeed devices must obey the same rules for using power but with higher 
limits of 150 mA for low-power and self-powered devices and 900 mA for 
high-power devices. 


Informing the Host 


During enumeration, the host learns whether the device is self powered or bus 
powered and the maximum current the device will draw from the bus. All hubs 
must have over-current protection that blocks excessive current to a device. 


If you connect a high-power device to a low-power hub on a Windows PC, 
you'll see a message informing you that the hub doesn't have enough power 
available. If the bus has a low-power device connected to a high-power port, 
Windows recommends swapping the device with the high-power device (Figure 
16-2). 

A device can support both bus-powered and self-powered options, using self 
power when available and bus power (possibly with limited abilities) otherwise. 


When a hub’s power supply is removed or turned off, the hub must remain in 
the Configured state, transition its downstream ports to the Powered Off state, 
and inform the host of the change via the hub’s Status Change endpoint. 


Battery Charging 


USB devices with rechargeable batteries can often recharge the batteries by con- 
necting to a USB host or hub or a dedicated charging unit. The USB 2.0 speci- 
fication doesnt define a way to draw charging currents greater than 500 mA or 
use bus current to charge batteries that are too weak to enable a device to enu- 
merate. 
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USB Hub Power Exceeded 


; The General purpose USB Hub is connected to a hub that does not have 
rae enough power available to support it. 





The devices shown in bold type can be supported by the hub to which the 
under-powered device is connected. 





Iz m My Computer (2 ports) 
(ig HID-compliant device 
E e General purpose USB Hub (4 ports) 
SB Hub 


General purpose 
Unused Port 
Unused Port 
Unused Port 








Recommendation 


Disconnect the General purpose USB Hub from its current location and switch it 
with one ofthe devices highlighted in bold. 





[I Disable USB error detection 





Figure 16-2. Windows warns users when they connect a high-power device to a 
low-power hub and helps them find an alternate connection. 


The USB-IF’s Battery Charging Specification addresses these needs and defines 
protocols for efficient and compliant charging of batteries in USB devices. The 
specification defines requirements for USB hosts, hubs, and dedicated devices 
that operate as USB chargers. A USB charger contains charger-detection cir- 
cuits so a device can learn if it's connected to a USB charger. 


The description that follows is based on V1.0 of the battery-charging specifica- 
tion. V2.0, in development at this writing, will likely define host protocols for 
managing the charging process. 
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Charger Types 
The specification defines three types of USB chargers: 


A host charger is a USB 2.0 host that can provide 500 mA to a port at any 
time and that supports charger detection. A low- or full-speed device must 
limit the current drawn from a host charger to 1.5A. A high-speed device 
must limit the current drawn from a host charger to 900 mA. A device that 
has connected to a host charger by pulling up D+ or D- can draw charging 
current even if the host has placed the device in the Suspend state. 


A hub charger is a USB 2.0 hub that can provide 500 mA to a downstream 
port for normal operation and supports charger detection. Devices that 
connect to hub chargers can draw the same charging currents as permitted 
for host chargers. 


A dedicated charger provides power from a USB connector but doesn’t enu- 
merate the attached device. The charger must connect its D+ and D- lines 
together via a 200Q resistor and must limit the charging current to under 
1.5A. The ability to use a USB connector is convenient for users and lowers 
manufacturing cost because the device doesnt need a vendor-specific con- 
nector or cable for charging. 


Charger Detection 

After detecting the presence of VBUS, a device can determine whether it’s con- 
nected to a USB charger by driving D+ to the VDAT_SRC voltage (0.5V—0.7V) 
and detecting the voltage on D-. If D- is greater than VDAT_REF (0.4V), the 
device is attached to a USB charger. 


A host or hub charger that detects a voltage between 0.4V and 0.8V on D+ 
drives D- to VDAT_SRC, which exceeds VDAT_REF. On a dedicated charger, 
D+ and D- are connected together and thus both exceed VDAT_REE Hosts and 
hubs that don’t function as USB chargers pull D- to ground via a 15K resistor, 
which brings D- below VDAT. REE 


395 


Chapter 16 


A device attached to a USB charger can determine the charger type after pulling 
up D+ (full speed) or D- (low speed) and detecting the voltage on the line not 
pulled up: 











Device Action Detected Charger Type 
Speed Voltage 
Full Pull D+ high |D- is low Host or hub 
D- is high Dedicated 
Low Pull D- high | D+ is low Host or hub 
D+ is high Dedicated 











To ensure valid voltages when connecting, a low-speed device must draw less 
than 100mA when it pulls D- high. The specification provides timing require- 
ments and other details for implementing charger detection. 


Charging Dead Batteries 


A dead-battery provision allows devices with dead or very weak batteries to 
draw up to 100 mA from a host or hub until the batteries are charged to a weak 
battery threshold. A device whose battery has charged to the weak battery 
threshold is capable of powering up successfully and connecting to the bus by 
pulling D+ or D- high. The device defines its weak-battery-threshold voltage. 
The provision also allows the bus to power a device that normally operates on 
battery power but has no batteries installed. 


Hub Power 


Power use on hubs has special considerations. A hub must control power to its 
downstream devices and must monitor power consumption and take action 
when devices use too much current and present a safety hazard. 


Power Sources 
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The root hub gets its power from the host. Other hubs are either self-powered 
or bus-powered. 


If the host uses AC power from a wall socket or another external source, a USB 
2.0 root hub must be capable of supplying 500 mA to each port on the hub. If 
the host is battery-powered, the hub may supply either 500 or 100 mA to each 
port. A hub that supplies 500 mA per port is a high-power hub, and a hub that 
supplies 100 mA per port is a low-power hub. 


Managing Power 


All of a bus-powered hub’s downstream devices must be low power. A USB 2.0 
hub can draw no more than 500 mA and the hub itself will use some current, 
leaving less than 500 mA for all attached devices combined. Thus you shouldn't 
connect two bus-powered hubs in series. The upstream hub can guarantee no 
more than 100 mA to each downstream port, and that amount doesn’t leave 
enough current to power a second hub that also has one or more downstream 
ports that each require 100 mA. 


An exception is a bus-powered compound device, which consists of a hub and 
one or more downstream, non-removable devices. In this case, the hub’s config- 
uration descriptor can report the maximum power required by the hub’s elec- 
tronics plus its non-removable device(s). The configuration descriptors for the 
non-removable device(s) report that the devices are self-powered with bMax- 
Power = 00h. The hub descriptor indicates whether a hub’s ports are removable. 


Like other high-power, bus-powered devices, a USB 2.0 bus-powered hub can 
draw up to 100 mA until configured and up to 500 mA after being configured. 
During configuration, the hub must manage the available current so its devices 
and the hub combined dont exceed the allowed current. 


Like other self-powered devices, a self-powered USB 2.0 hub may also draw up 
to 100 mA from the bus so the hub interface can continue to function when the 
hub’s power supply is off. If the hub’s power is from an external source such as 
AC power from a wall socket, the hub is high power and must be capable of 
supplying 500 mA to each port on the hub. If the hub uses battery power, the 
hub may supply 100 or 500 mA to each port on the hub. 


USB 3.0 raises the current limits. USB 3.0 hubs can provide up to 900 mA per 
port if high power and 150 mA per port if low power. If the upstream port isn’t 
connected, the hub doesn’t provide power to the downstream ports unless the 
hub supports the USB battery charging specification. 


Over-current Protection 


As a safety precaution, hubs must be able to detect an over-current condition, 
which occurs when the current used by the total of all devices attached to the 
hub exceeds a set value. On detecting an over-current condition, a hub’s port 
circuits limit the current at the port, and the hub informs the host of the prob- 
lem. Windows warns the user when a device exceeds the current limit of its hub 
port (Figure 16-3). 

The current that triggers the over-current actions must be less than 5A. To 
allow for transient currents, the over-current value should be greater than the 
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USB Hub Current Limit Exceeded 


AN An unknown device has exceeded the current limits of its hub port. 


















The placement of the device is highlighted in bold type. 





= USB Root Hub (2 ports) 
(xj HID-compliant device 
E e General purpose USB Hub (4 ports) 
Unused Port 
Unused Port 


à Unknown USB Device 


Unused Port 





Recommendation 


Disconnectthe device and then click 'Reset' to re-enable the port. If you click 
‘Close’, a reboot will be required to regain the port. 





[ Disable USB error detection 


Figure 16-3. When a device exceeds the current limit of its hub's port, Windows 
warns the user and offers assistance. 


total of the maximum allowed currents for the devices. In the worst case, seven 
high-power, bus-powered, USB 2.0 downstream devices can legally draw up to 
3.5A. So a supply for a self-powered hub with up to seven downstream ports 
would provide much less than 5A at all times unless something goes very 
wrong. A hub can implement multiple over-current gangs. 


A device can briefly draw a larger inrush current on attachment to the bus. The 
over-current protection circuits typically don’t see the inrush current because a 
capacitor downstream from the protection provides the stored energy. If the 
inrush current is too large, the device will fail compliance tests. 
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Power Switching 


A bus-powered hub must support power switching that can provide and cut off 
power to downstream ports in response to control requests. A single switch may 
control all ports, or the ports may switch individually. A self-powered hub must 
support switching its ports to the Powered Off state and may also support 
power switching via control transfers. 


Saving Power 


All USB devices must support the low-power Suspend state. Additional 
low-power states enable conserving power with quicker transitions and less 
stringent requirements than Suspend. With host support, USB 2.0 devices can 
use the Sleep state. SuperSpeed devices can support the U1 and U2 low-power 
states. 


USB 2.0 Link Power Management 


The USB 2.0 Link Power Management (LPM) Addendum to the USB 2.0 speci- 
fication defines four USB link power management states. SuperSpeed-capable 
devices must support link power management when operating at high speed. 
USB 2.0 devices may also support link power management. A link consists of a 
cable segment and the two ports, or link partners, the cable connects. 

The addendum assigns names to conditions described in the USB 2.0 specifica- 
tion and adds the new L1 (Sleep) state: 

LO (On). The link is carrying data or is able to do so. When not carrying data, 
the link carries SOF (full and high speed) or keep-alive (low speed) signals. 

L1 (Sleep). The link doesn’t carry data or SOF/keep-alive signals. The device 
may reduce power consumption. 

L2 (Suspend). The link doesn’t carry data or SOF/keep-alive signals. The 
device must reduce power consumption. 

L3 (Off). The link is powered off, disconnected, or disabled and isn't capable of 
performing data signaling. 

The USB 2.0 Phase-locked SOFs ECN to the USB 2.0 specification can help iso- 
chronous devices save power. To comply with the ECN, SOFs issued on exiting 
the Sleep or selective Suspend states must be in phase lock with the SOFs that 
preceded the low-power state. Isochronous devices can thus enter a low-power 
state and maintain synchronization to SOFs on returning to full power. 
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Suspend State 
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The Suspend state reduces a devices use of bus power when the host doesn’t 
need to communicate. A USB 2.0 device must enter the Suspend state when 
the bus has had no activity for 3 ms. 


While in the Suspend state, a device must draw no more than 2.5 mA from the 
bus. A device that needs to function when the host has ceased communicating 
may need to be self-powered. However, many device controllers can consume 
very little power while remaining able to detect activity requiring attention on 
an I/O pin and wake the host as needed. 


Global and Selective Suspends 


In a global suspend, a USB 2.0 host stops communicating with the entire bus, 
which carries no traffic or SOFs. When a full-or high-speed device detects that 
no SOF has arrived for 3 ms, the device enters the Suspend state. Low-speed 
devices do the same when they havent received a low-speed keep-alive signal for 
3 ms. A device must be in the Suspend state within 10 ms of no bus activity. 


A host may also request a selective suspend of an individual port. The host 
issues the class-specific Set Port Feature request to a hub with wIndex set to a 
port number and wValue set to PORT. SUSPEND. The request instructs the 
hub to stop sending any traffic, including SOFs or low-speed keep-alives, to the 
specified port. 


Current Limits for Suspended Devices 


A device in the Suspend state should consume maximum of 2.5 mA of bus cur- 
rent averaged over 1 s. The limit includes current through the pull-up on D+ or 
D-. 

The USB 2.0 specification defined a limit of just 500 uA for devices that dont 
support remote wakeup. However, the limit was difficult for many devices to 
meet, and in 2008, the USB-IF raised the limit with the ECN Suspend Current 
Limit Changes. USB 3.0 also uses the new limit. 


Configured, bus-powered hubs and configured, bus-powered compound 
devices can draw up to 12.5 mA when suspended. A bus-powered hub can thus 
consume 2.5 mA while providing 2.5 mA for each of up to four downstream 
ports. 
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Resuming Communications 


To resume communications on a suspended bus, a host places the bus in the 
Resume state (the K state, defined in Chapter 18) for at least 20 ms. The host 
follows the Resume with a low-speed EOP. The host then resumes sending 
SOFs and any other communications. (For low-speed devices, the nearest hub 
issues low-speed keep-alive signals instead of sending SOFs.) For selectively sus- 
pended devices, a host can request a hub to resume communications on a 
downstream-facing port by issuing a Clear Port Feature(PORT_SUSPEND) 
request. 


A device that wants to be able to request to resume communications indicates 
support for remote wakeup in the configuration descriptor’s bmAttributes field. 
The host enables remote wakeup by sending a Set Port Fea- 
ture(DEVICE_REMOTE_WAKEUP) request to the hub port that is the 
device’s link partner. A suspended device with remote wakeup enabled can 
request to resume communications by driving the upstream bus segment in the 
Resume state for 1-15 ms. The device then places its drivers in a high-imped- 
ance state to enable receiving traffic from the upstream hub. The resume signal- 
ing propagates upstream to the first non-suspended hub, which may be the root 
hub. When the resume signaling has completed, the device again receives SOFs 
or low-speed keep-alives and other traffic. A device may initiate a Resume any 
time after the bus has been idle for at least 5 ms. The host must allow a device 
at least 10 ms to recover from a Resume. 


Some device controllers require firmware support to monitor the bus to deter- 
mine when to enter the Suspend state, while other controllers handle the task 
entirely in hardware. The device' serial interface engine typically handles the 
resume signaling without firmware support. 


When a device uses bus power, firmware may need to control power to external 
circuits, removing power on entering the Suspend state and restoring power on 
resuming. A power switch with soft-start capability can limit current surges 
when switching. Micrel Inc. has power-distribution switches suitable for use 
with USB devices. Each switch contains one or more high-side MOSFET 
switches with soft-start capability. 


Sleep State 


The L1 Sleep state provides a way for devices to reduce power consumption 
without having to meet the Suspend state’s stringent requirements. The Sleep 
state also enables faster transitions to and from the powered state. A major pur- 


401 


Chapter 16 


pose in defining the Sleep state was to provide a more effective mechanism for 
power conservation on mobile, battery-powered platforms. 


In the Sleep state, a device receives no USB traffic including SOFs or keep-alive 
signaling. The device can reduce power consumption but isn’t required to do so. 


To place a device in the Sleep state, a host issues a Set_and_Test(PORT_L1) 
request to the hub that is the device’s link partner. A hub that supports the 
Sleep state then initiates an LPM transaction to the device by issuing a token 
packet with an EXT Packet ID, followed by an extended token packet with an 
LPM Packet ID (0011b). (Chapter 2 covered Packet IDs.) In the LPM token 
packet, the bmAttributes field requests the Sleep state and provides information 
used in resume signaling (Table 16-1). 


A device that receives an EXT token packet followed by an LPM token packet 
can return ACK (ready to transition to the Sleep state), NYET (not ready to 
transition to the Sleep state), STALL (requested link state not supported), or no 
response (the device doesn’t support the transaction type or detected an error). 


The hub NAKs the Data stage of the Set_and_Test request as needed until the 
downstream device returns ACK or STALL or fails to respond after three 
attempts. The hub then returns a completion code in the Data stage of the 
request. 


To resume communications with a device in the Sleep state, a host issues a 
Clear Port Feature(PORT_L1) request to the device’s link partner. The hub 
then initiates resume signaling with the device. The signaling is identical to a 
resume from Suspend except for timing. The HIRD value in the LPM token 
packet indicates how long the hub will hold the line in the Resume state when 
exiting Sleep. The encoded value can specify a range from 50 ys to 1.2 ms. 

In the LPM token packet, if bRemoteWake - 1, the device can request to wake 
the host by driving the line in the Resume state for 50 us. 

A host that doesn't support the Sleep state will never request it. Devices that 


dont support the Sleep state can return STALL or no response to token packets 
that contain the LPM Packet ID. 
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SuperSpeed offers more ways to conserve power, including new low-power 
states and latency tolerance messages that help the host manage power on the 
bus and for the system. 


Managing Power 


Table 16-1: In an LPM extended token packet, the bmAttributes field provides 
information about the requested Sleep state. 














Bits Field Description 
10..9 Reserved For future use. 
8 bRemoteWake |1 = the device can wake the host. 
0 = the device cannot wake the host. 
7.4 HIRD Host initiated resume duration (encoded value) 
3..0 bLinkState 0001 = L1 (Sleep). 





Other values reserved. 








If you're developing a device that must use as little power as possible, you might 
choose to support SuperSpeed even if the application doesn’t require fast perfor- 
mance. With SuperSpeed's extremely fast data transfers and new low-power 
states, some devices can save significant power by entering a low-power state 
between transactions. 


Link States 


SuperSpeed defines four operational link states: 


* UO is normal operation and is the highest link state. (Note that UO has the 
lowest number but the highest power and thus is considered the highest 
link state.) This is the only state where the link can carry packets. 

e Ul isa low-power state with fast transitions to UO. The state has no man- 
dated reduction in bus current, but the link carries no signaling and the 
device can implement power-saving measures. 

* U2 is a more aggressive low-power state with slower transitions to UO. The 
state has no mandated reduction in bus current, but the link carries no sig- 
naling, and the device can turn off clock circuits and implement other 
power-saving measures that require more time to transition to UO. 

e U3 is the Suspend state and is the lowest link state. The link carries no sig- 
naling, and a device whose port is in U3 can draw up to 2.5 mA of bus cur- 
rent. A device in the Suspend state must detect Warm Reset (defined in 
Chapter 18) and wakeup signaling. A device that supports remote wakeup 
must be capable of sending wakeup signaling. 

In addition to the above states, which apply to links, a SuperSpeed device can 
have one or more functions in the function suspend state while the link and 
other function(s) in the device may remain in a higher-power state. 
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For each device, the host calculates U1 and U2 System Exit Latency values that 
are a measure of the time required to transition from U1 or U2 to UO. For 
devices with interrupt or isochronous endpoints, the host uses these values in 
determining whether the device can initiate U1 or U2. If the corresponding 
Latency value plus one bus interval is greater than the shortest service interval 
on the device, the host doesnt allow the device to initiate the low-power state. 


A link that is in UO and is not transmitting data or other packets is in the logi- 
cal idle state and transmits encoded zeroes. A link in U1, U2, or U3 is in the 
electrical idle state and carries no signaling. 


Changing States 


Link-level communications control the state of a link. The host doesnt need to 
know the state of every link on the bus. To conserve power, if a link has no 
pending upstream traffic, a hub transitions its upstream port to the lowest link 
state possible. In other words, if a hub's downstream ports are in U1 and U2, 
the hub can place its upstream port in U1. If all of the ports are in U2, the hub 
can reduce power further by placing its upstream port in U2. Only a host can 
request a transition to U3. When a host or hub wants to communicate with a 
device, any links in the communication path that arent in UO must transition 
to U0. 


The mechanism for changing a power state varies with the state, who initiated 
the change, and whether the change applies to an entire link or a function in a 
device. Hubs implement host-programmable inactivity timers for each down- 
stream-facing port for use in determining when to enter U1 and U2. Isochro- 
nous Timestamp packets don’t prevent a device from entering a low-power 
state. To exit a low-power state, a link uses a hardware handshake implemented 
via low-frequency periodic signaling (LFPS). 


U1 

A host, hub, or device can request a transition to U1. The host can send a 
hub-specific Set Port Feature (PORT_LINK_STATE) request for a down- 
stream-facing port on a hub. The hub then uses hardware-generated link com- 
mands to implement the state change on the link. When a hub’s 
downstream-facing port is in UO and an inactivity timer detects no bus activity 
on the port for the timer’s specified period, the hub uses link commands to 
request to transition the link to U1. A device can use a device-specific policy in 
deciding when to request U1 entry via link commands. In all cases, the link 
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partner can refuse to change to the requested state for example, if the port will 
soon have traffic to send or doesnt support U1. 


When a host or device has a packet ready to transmit, a hardware handshake 
initiates exit from Ul to UO. 


U2 
When a link is in U1, if the downstream port supports U2 and the link part- 
ners’ U2 inactivity timers time out, the link silently transitions to U2. When a 


host or device has a packet ready to transmit, a hardware handshake initiates 
exit from U2 to UO. 


U3 

Unlike USB 2.0, SuperSpeed doesn’t support global suspends, where the host 
places the entire bus in the Suspend state by ceasing to send timing markers. 
SuperSpeed supports only selective suspend and function suspend. 


In a selective suspend, a device enters the Suspend state on detecting that the 
devices link is in U3. Set Port Feature (PORT. LINK. STATE, U3) requests a 
hub to place a downstream-facing port and its link in U3. The hub uses hard- 
ware-generated link commands to implement the state change on the link. The 
downstream device enters the Suspend state on detecting that the link is in U3. 


To suspend the entire bus, the host must request each downstream port on the 
bus to enter U3. When all of a hub’s downstream ports are in U3, a host places 
the hub’s upstream link in U3. Only a host can request to place a link in U3, 
and hubs must accept requests to place an enabled downstream port in U3. 


To wake a device, the host sends a Set Port Feature (PORT_LINK_STATE, 
UO) request to the downstream-facing hub port that is the device’s link partner. 
The hub uses hardware-generated link commands to transition the link to U0. 
On detecting that the link is in UO, the downstream device exits the Suspend 
state. A device can initiate exit from U3 via low frequency periodic signaling as 
described below under Function Suspend. 


Function Suspend 

For finer power control, a USB 3.0 host can place an individual function in the 
function suspend state while allowing other functions in the device (if any) to 
continue to communicate on the bus. To suspend a function, the host issues a 
Set Port Feature(FUNCTION_SUSPEND) request to an interface. In the high 
byte of wIndex, bit 0 requests the suspend state or normal operation, and bit 1 
enables or disables function remote wakeup. 


405 


Chapter 16 


406 


To resume communications with a suspended function, a host issues a Set Port 
Featur(FUNCTION SUSPEND) request for normal operation. Note that 
exiting function suspend uses Set Port Feature rather than Clear Port Feature. If 
the device's link isn't in UO, the downstream-facing hub port that is the device's 
link partner uses low frequency periodic signaling to initiate the transition to 
UO. The hub then resumes communicating with the function. 


A function with remote wakeup enabled can request to wake by sending a 
DEV NOTIFICATION Transaction Packet with a Function Wake notifica- 
tion. If the devices link isn't in UO, before sending the notification, the device 
uses low frequency periodic signaling to transition the link to UO. The signaling 
propagates upstream from the device until reaching a hub that isn't in U3 and 
then propagates back downstream to the device requesting the wakeup. 


If the host places a device in the Suspend state when one or more functions are 
suspended, the functions remain suspended when the device wakes. The host or 
device must then initiate exiting function suspend for the individual func- 
tion(s). Both composite and non-composite devices can use function suspend. 


Informing the Host of Delays 

Hubs help manage bus traffic by informing the host of delays due to a device's 
being in a low-power state. On receiving a header packet addressed to a port in 
a low-power state, the hub sends a deferred header packet to the host, which 
halts communication attempts with the device. When the target port has transi- 
tioned to UO, the hub sends the header packet to the device with the Deferred 
bit set in the Link Control Word. To inform the host that the device is ready to 
communicate, the device sends an ERDY Transaction Packet. 


Latency Tolerance Messages 


USB 3.0 hosts can save additional power by obtaining information about the 
maximum delay each device can tolerate between sending an ERDY Transac- 
tion Packet and receiving a response from the host. The host can use more 
aggressive power management with devices that can handle long delays. The 
protocols for obtaining this information include the Set Fea- 
ture(LTM. ENABLE) and Set SEL requests and DEV NOTIFICATION 
Transaction Packets with Latency Tolerance Message Device Notifications. The 
SuperSpeed USB device capability descriptor indicates whether a device sup- 
ports Latency Tolerance Message notifications. 
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Using PING 


If a host initiates an isochronous transaction with a device in a low-power state, 
the device might be unable to transition to UO in time to send or receive data in 
the scheduled service interval. To prevent this problem, the host uses PING and 
PING. RESPONSE Transaction Packets. Before beginning the isochronous 
transfer, the host sends a PING Transaction Packet, which causes all links 
between the device and host to transition to UO. The device returns a 
PING. RESPONSE Transaction Packet when the device is ready to transfer 
data. The host must send the PING far enough in advance of a scheduled trans- 
fer to enable the transfer to take place on time. 


This use of PING is unrelated to the high-speed PING protocol described in 
Chapter 2. 


Power Management under Windows 


Recent PCs manage power according to the Advanced Configuration and Power 
Interface Specification (ACPI). A system that implements ACPI power manage- 
ment enables the operating system to conserve power by shutting down compo- 
nents, including suspending the USB bus, when the computer is idle. 


PCs support these low-power, or sleeping, states: 


In the S1 state, the display is off and drives are powered down. USB buses 
are suspended, but VBUS remains powered. 


In the S3 state, the PCI bus's main power supply is off and memory isnt 
accessed, but system memory continues to be refreshed. USB buses are sus- 
pended. In older systems, USB's VBUS is not powered in the S3 state. In 
newer systems, VBUS is powered by the PCI bus’s auxiliary supply (Vaux). 


In the S4 state, the system context is saved to disk and the system, including 
the USB bus, is powered off. 


You can view and change a system's power-management options in Control 
Panel » Power Options. Under Windows Vista, you can specify when the sys- 
tem enters S3, called sleep (Figure 16-4). The Advanced Settings tab includes 
options to enable or disable selective suspend for USB devices under USB set- 
tings and to select hibernation (S4) under Battery » Critical battery action. 

Under Windows XB the Power Schemes tab specifies when the system goes into 
standby and hibernation. Standby is either S1 or S3. On a system that has no 
USB devices that can wake the system, standby is 53. On a Windows XP sys- 
tem that has a USB keyboard, mouse, or another USB device that can wake the 
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Change settings for the plan: Balanced 


Choose the sleep and display settings that you want your computer to use. 


[c] Turn off the display: 5 minutes =| |20minutes 


® Put the computertosieep: 15 minutes > 1 hour 


Change advanced power settings 


Restore default settings for this plan 








j On battery A Plugged in 
$ Power Options (v miim] 


Advanced setings 





" Select the power plan that you want to customize, 
Pp and then choose settings that reflect how you want 
your computer to manage power. 


Balanced [Active] - 
$ Sleep ^ 


USB selective suspend setting 

On battery: Enabled 

Plugged in: Disabled 
3 Power buttons and lid 
a PCI Express 
3 Search and Indexing = 
| a Display 

$ Multimedia settings 
x» Battery | 






Restore plan defaults 


OK Í Cancel 








Figure 16-4. Windows Vista enables users to specify power-saving options that 
determine when USB devices enter the Suspend state. 
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system, the standby state is S1 due to problems in using S3 with some BIOSes 
and device hardware. The problems include loss of VBUS in the S3 state, false 
device removal and arrival notifications on resuming, resetting of devices during 
suspend and resume, and failure to resume fully. 


For devices that have problems resuming from S3, a possible fix is to force the 
host controller to reset on resuming by adding a ForceHCResetOnResume 
value to the host controller’s registry key. This approach is imperfect because 
some devices require a host-controller reset while others require no reset. To 
avoid problems, device designers should take care that their products behave 
properly whether the host controller resets or not. 


To enable or disable remote wakeup capability for a specific device that sup- 
ports remote wakeup, in Windows’ Device Manager, select the device, 
right-click, select Properties > Power Management, and check or uncheck Allow 
this device to bring the computer out of standby. 


1/7 


Testing and Debugging 


Besides the chip-specific development boards and debugging software described 
in Chapter 6, a variety of other hardware and software tools can help with test- 
ing and debugging USB devices and their host software. This chapter intro- 
duces tools available from the USB-IF and other sources. I also explain what’s 
involved in passing tests for the Certified USB logo and Windows logo. 


Tools 


Without a doubt the most useful tool for USB device developers is a protocol 
analyzer, which enables monitoring USB traffic and other bus events. The ana- 
lyzer collects data on the bus and decodes and displays the requested data. You 
can watch what happened during enumeration, detect and examine protocol 
and signaling errors, view data transferred during control, interrupt, bulk, and 
isochronous transfers, and focus on specific aspects of a communication. 

A hardware analyzer is a combination of hardware and software, while a soft- 
ware analyzer consists only of software that runs on the device’s host computer. 
The capabilities of the two types overlap, but each can also record and display 
information that isn’t available to the other type. 
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Figure 17-1. A hardware protocol analyzer monitors traffic between a device 
under test and the device's host. An interface to a PC (or logic analyzer) 
enables viewing the captured data. 


Another useful tool is a traffic generator, which emulates a host or device and 
offers precise control over what goes out on the bus. 


Hardware Protocol Analyzers 


A hardware protocol analyzer is a piece of equipment that captures the signals 
in a cable segment without affecting the traffic in the segment. The analyzer 
connects in a cable segment upstream from the device under test (Figure 17-1). 
To enable viewing the captured traffic, the analyzer connects to a PC or logic 
analyzer. A connection to a PC may use USB or another port type such as 
Ethernet. Instead of a PC interface, some protocol analyzers connect to logic 
analyzers from Agilent or Tektronix. 

With a hardware analyzer, you can see the data in the cable down to the indi- 
vidual bytes that make up each packet. There's no question about what the host 
or device did or didn’t send. For example, if the host sends an IN token packet, 
you can see whether the device returned data or a NAK. You can view the pack- 
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ets in every stage of a control request. Time stamps enable you to see how often 
the host accesses an endpoint. 


Analyzers are available from a variety of vendors and in a range of prices, 
including models that support SuperSpeed. If you develop only low- and 
full-speed devices, an analyzer that supports only these speeds can save on cost. 


In this chapter, I use the Ellisys USB Explorer 200 USB 2.0 analyzer to illus- 
trate the kinds of things you can do with an analyzer. Vendors update and 
improve their products, and new products become available, so check for the 
latest information when youre ready to buy. 


The Hardware 


The Explorer 200 requires two USB host controllers. One communicates with 
the analyzer and the other controls the bus being monitored. Both host control- 
lers can be in the same PC, but when analyzing high-bandwidth traffic, using 
two PCs can prevent overflow errors. 


One USB cable connects the Explorer to the PC running the Explorer’s Visual 
USB Analysis software. The PC detects the Explorer as a USB device that uses a 
vendor-specific driver provided by Ellisys. 


Two additional USB cables connect the analyzer in a cable segment upstream 
from the device being tested. One cable connects the analyzer to the device 
being tested or a hub upstream from the device. The other cable connects the 
analyzer to the host’s root hub or another hub upstream from the analyzer. The 
combined length of the two cables should total 3 m or less. The cables must be 
short because the host and device should detect no difference in the bus traffic 
when the analyzer is present. The cables and the analyzer’s electronics together 
emulate an ordinary cable segment of 5 m or less. 


The Software 


The Ellisys Visual USB Analysis Software enables you to start and stop data log- 
ging and to save, view, and print the results. Figure 17-2 shows data captured by 
an analyzer. You can specify the amount, type, and format of data the displayed. 
For less detail, you can elect to hide individual packets, repeated NAKs, and 
other information. You can specify criteria to display such as specific devices, 
endpoints, speeds, status codes, and control requests. 


A Details pane provides more information about a request, transaction, packet, 
or other item in a row in the application’s main window (Figure 17-3). A Data 
pane displays the individual bytes in hexadecimal and ASCII. You can also 
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| Device | Endpoint | Status | Speed | Time 

EE Suspended (159.2 ms) 3.954 854 458 
XE Reset (11.0 ms) 4.114 037 395 
oE GetDescriptor (Device) 0 (1) 0 OK FS 8 bytes (12 01 00 02 00 00 00 08) 4.189 013 687 
a SETUP transaction O (1) 0 ACK FS 8 bytes (80 06 00 01 00 00 40 00) 4.189 013 687 
+ SETUP packet 0 0 FS 4.189 013 687 

» DATAO packet FS 8 bytes (8006 00 01 00 004000) 4.189 016 750 

+ ACK packet ACK FS 4.189 025 333 

ae: IN transaction oa) 0 ACK FS 8 bytes (12010002 00000008) 4.190013 520 
+ IN packet 0 0 FS 4.190 013 520 

+ DATA1 packet FS 8 bytes (12010002 00000008) 4.190016 625 

+ ACK packet ACK FS 4.190 025 479 

8 QUT transaction 0 (1) 0 ACK FS No data 4.192 013 250 
+ QUT packet 0 0 FS 4.192 013 250 

+ DATAI packet FS No data 4.192 016 312 

* ACK packet ACK FS 4.192 019 583 

AE Reset (11.0 ms) 4.198 025 750 
a6 SetAddress (1) o) (0 OK FS No data 4.264 005 604 
© SETUP transaction O(1) 0 ACK FS 8 bytes (0005010000000000) 4.264 005 604 
» SETUP packet 0 0 FS 4.264 005 604 

+ DATAO packet FS 8 bytes (0005 0100 00000000) 4.264 008 666 

+ ACK packet ACK FS 4.264 017 270 

B IN transaction oü) 0 ACK FS No data 4.265 005 375 
+ IN packet 0 0 FS 4.265 005 375 

+ DATA1 packet FS No data 4.265 008 458 





Figure 17-2. Ellisys’ USB Explorer 200 protocol analyzer includes Visual USB 
application software for viewing captured data. This example shows 
transactions and other events that occurred when a device was attached 


search for specific items, including events, token-packet types, traffic to and 
from a specific device or endpoint, and data. 


Additional software modules add support for triggering on events, decoding 
class-specific information, and exporting captured data in text, XML, and other 
formats. 


Software Protocol Analyzers 
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A software-only protocol analyzer runs on the host computer of the device 
being tested. You can view traffic to and from any device that connects to any of 
the computers host controllers. 


A software analyzer can display driver information that a hardware analyzer 
cant access. As Chapter 8 explained, Windows drivers communicate with USB 
devices using I/O Request Packets (IRPs) that contain USB Request Blocks 
(URBs). A software analyzer can show the IRPs and URBs that a driver has sub- 


mitted and the responses received from a device. 
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® Setup request « 
Value Dec Hex Bin 
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VbmRequestType.Direction |Host-to-device 0 0x0 0 
V bRequest SET ADDRESS z 0x05|00000101 
00000001 
00000000 
Y wLength is) 0/0x0000/00000000 
[^ 


Figure 17-3. The Details pane in Ellisys’ Visual USB software has more 
information about a request, transaction, packet, or other event. 


Software analyzers don't show anything that the host-controller or hub hard- 
ware handles on its own. For example, the analyzer won't show how many times 
an endpoint NAKed a transaction before returning an ACK or the precise time 
a transaction occurred on the bus. 


Some software analyzers use a filter driver that loads when the operating system 
loads the driver for the device being monitored. Because the filter driver doesn’t 
load until the host has enumerated the device, the analyzer can't show the enu- 
meration requests and other events that occur at device attachment. 


Sourcequest, Inc.'s SourceUSB is a software analyzer that records USB I/O 
requests and other events, including enumeration requests. You can view the 
requests along with additional information about the systems host controllers, 
the devices on the host controllers’ buses, and the drivers assigned to each host 
controller and device. Figure 17-4 shows logged requests and additional infor- 
mation about the request in the selected row. 


The SourceUSB application can also display a tree of all of the system's host 
controllers and their attached devices and provide information about the drivers 
assigned to each host controller and device. As with a hardware analyzer, you 
have much flexibility in selecting what information you want to log and view. 


Another software-only analyzer is the SnoopyPro project, free with source code 
from www.sourceforge.net. 
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URB_FUNCTION_BULK_OR_INTERRUPT_TRANSFER 





Irp 82ac8008 
NTSTATUS STATUS. SUCCESS (00000000) 

DeviceObject USBPDO- 15 (82edade8) 

DriverObject: 22? 











URB Field Value 
URB Length 72 bytes 











URB Status USBD_STATUS_SUCCESS 
TransferFlags IN, SHORT_TRANSFER_OK 
TransferBufferL ength. 3 bytes 
TransferBuffer i 





Pipe. Information 



































Field oae Vale —— "———— 
InterfaceNumber Q 
EndpointAddress 0x81 (IN,1) 
PipeType Interrupt 
D Interval 10 
B PipeHandle S2e54cdcH 
Ready [si jet 


Figure 17-4. SourceUSB’s application shows USB I/O requests at a host 
computer. These requests are for mouse communications. 


Traffic Generators 


Sometimes it's useful to be able to control bus traffic and signaling beyond what 
you can do from host software and device firmware. Some protocol analyzers 
can also function as traffic generators that emulate a host or device and give you 
precise control over the traffic that the emulated host or device places on the 
bus. In addition to generating valid traffic, a traffic generator can introduce 
errors such as bit-stuff and CRC errors. RPM Systems’ Root 2 USB Test Host 
emulates a USB host and enables you to specify traffic to generate on the bus, 
control the bus voltage, and measure bus current. 


The USB-IF provides a free USB 2.0 Single Step Transaction Debugger tool that 
enables initiating individual transactions with a high-speed device, including 
sending standard control requests. 
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Testing 


The USB-IF and Microsoft offer testing opportunities for developers of USB 
devices and host software. Passing the tests can earn a product the right to dis- 
play a Certified USB logo and one or more Microsoft Windows logos, or both 
types. A logo can give users confidence that a device will work as advertised. A 
driver that passes Microsoft’s tests can receive a digital signature that enables the 
driver to install without security warnings. 


Compliance 


The USB-IF's compliance program provides tests for peripherals, hubs, host 
systems, On-The-Go devices, silicon building blocks, cable assemblies, and 
connectors. On passing the tests, the USB-IF asserts that the product has “rea- 
sonable measures of acceptability" and adds the product to its Integrators List of 
compliant devices. On receiving a signed license agreement and fee payment, 
the USB-IF authorizes the product to display a Certified USB logo. Even if you 
dont submit your device to formal compliance testing, you can use the tests to 
verify your devices performance. 


To pass compliance testing, a device must meet the requirements specified in 
the appropriate checklists and pass tests of the device's responses to standard 
control requests, operation under different host-controller types and with other 
devices on the bus, and electrical performance. The USB 2.0 tests other than 
high-speed electrical tests are described in Universal Serial Bus Implementers 
Forum Full and Low Speed Electrical and Interoperability Compliance Test Proce- 
dure. The specifications, procedures, and tools for high-speed electrical tests are 
in additional documents and files on the USB-IF’s website. Also check the web- 
site for news on USB 3.0 compliance tests. 

You can submit a device for compliance testing at a compliance workshop spon- 
sored by the USB-IF or at an independent lab authorized by the USB-IF. To 
save time and expense, perform the tests as fully as possible on your own before 
submitting a product for compliance testing 


Checklists 


The compliance checklists contain a series of questions about a product's speci- 
fications and behavior. There are checklists for peripherals, hubs, hub and 
peripheral silicon, and host systems. The Peripheral checklist covers mechanical 
design, device states and signals, operating voltages, and power consumption. 
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Accompanying each question is a reference to a section in the USB specification 
with more information. 


Device Framework 


The Device Framework tests verify that a device responds correctly to standard 
control requests. The USB Command Verifier (USBCV) software utility per- 
forms the tests. The USB Command Verifier Compliance Test Specification 
describes the tests. The USBCV software and test-specification document are 
available from the USB-IF’s website. 


The USBCYV software requires a PC with a USB 2.0 host controller. In addi- 
tion, any low- or full-speed devices being tested must connect to the host via an 
external USB 2.0 hub. When you run USBCYV, the software replaces the 
host-controller's driver with its own test-stack driver. On exiting USBCV, the 
software restores the original driver. 


The USB-IF recommends running the software only on hosts that are using 
Microsofts USB drivers. You can run the tests while using a USB mouse and 
keyboard, or you can use a PS/2 mouse and keyboard if the system supports 
them. Before running USBCV, create a Windows restore point so you can 
return to your previous system configuration if something goes wrong with the 
stack switch. 


The software has test suites for Chapter 9, Current Measurement, HID, Hub, 
and OTG. 


In the Chapter 9 tests, the host issues the standard control requests defined in 
Chapter 9 of the USB 2.0 specification and performs additional checks on the 
information returned by a device (Figure 17-5). For example, on retrieving a 
device descriptor, the software checks to see that the bMaxPacketSize0 value is 
valid for the devices speed and that the bDeviceClass value is either a value for 
a standard class or FFh (vendor-defined). The software requests the device 
descriptor when the device is in the default, address, and configured states, at 
both full and high speeds if the device supports both, and in every supported 


configuration. 
The Chapter 9 tests also include these: 
* Enumerate the device multiple times with different addresses. 


* Verify that all bulk and interrupt endpoints can be halted and unhalted 
with Set Feature and Clear Feature requests. 
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USB-IF Compliance Test Tool 





m Test Execution 
DeviceDescriptorTest DeviceConfigured Passed 
DeviceDescriptorTest DeviceAddressed Passed 
ConfigDescriptorTest DeviceConfigured Passed 
ConfigDescriptorTest DeviceAddressed Passed 
InterfaceDescriptorTest Passed 
EndpointDescriptorTest DeviceConfigured Passed 
EndpointDescriptorTest DeviceAddressed Passed 
HaltEndpointTest Passed 
SetConfigurationTest Passed 
SuspendResumeTest Passed 
RemoteWakeupTestEnabled Passed 
RemoteWakeupTestDisabled Passed 
EnumerateTest Passed 
Run Test Suite Abort Testing Return To Main 


TEE Laa am ———E-^ÓÓ—————— 


Number of: Fails (0); Aborts (0); Warnings (0) ] 
Now Starting Test Remote Wakeup Test (Configuration Index 0) 
Suspended the parent port of the device 
Did not receive a wakeup event on the test device with remote wakeup disabled 
Stopping Test [Remote Wakeup Test (Configuration Index 0): 
Number of: Fails (0); Aborts (0); Warnings (0) ] 
Now Starting TestEnumeration Test (repeat 150 times) 


Device speed is Low 

Stopping Test [ Enumeration Test (repeat 150 times): 
Number of: Fails (0); Aborts (0); Warnings (0) ] 

Summary Log Counts [ Fails (0); Aborts (2); Warnings (4) ] 











Figure 17-5. USBCV’s Chapter 9 tests check the device’s responses to the 
control requests defined in Chapter 9 of the USB specification. 


* Ensure that the device returns STALL in response to receiving a request for 
an unsupported descriptor type. 


* Ensure that the device returns STALL in response to receiving a Set Feature 
request for an unsupported feature. 


* Suspend and resume the device. 


* [f the device supports remote wakeup, suspend the device and request the 
user to perform an action to wake the device. 
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The Current Measurement test suite pauses with the device in the unconfigured 
and configured states to enable measuring the bus current. In the unconfigured 
state, the device should draw no more than 100 mA. When configured, the 
device should draw no more than the amount specified in the bMaxPower field 
of the configuration descriptor for the currently active configuration. 


Additional test suites provide tests for hubs, HID-class devices, and devices that 
return On-The-Go descriptors. 


The software has two modes. Compliance Test mode runs an entire test suite. 
Debug mode enables selecting and running a single test within a suite and 
offers more control, such as selecting a configuration to use when running a 
test. 


Interoperability Tests 


The interoperability tests emulate a user’s experience by testing a product with 
different host controllers and with a variety of other USB devices in use. The 
device must be tested under both EHCI/UHCI and EHCI/OHCI hosts and 
under hubs that do and don’t support high speed. To enable testing both imple- 
mentations of the S3 Sleep state, the device must be tested under a host that 
maintains VBUS and a host that removes VBUS on entering the S3 state. 
Devices are tested under these conditions: 


* The bus is carrying control, bulk, interrupt, and isochronous transfers. 
* There are five external hubs between the device and host. 

* The device is 30 m from the host (28 m for low-speed devices). 

* The bus is carrying full- and high-speed traffic. 


For performing the tests, the test specification defines a Gold Tree configura- 
tion that contains a variety of hubs and other devices on the bus with the device 
under test. The test specification revision 1.3 lists these devices in the Gold 
Tree: 


* Video camera: high speed, uses isochronous transfers, high power, bus pow- 
ered. 


Mass storage device: high speed, uses bulk transfers, self powered. 
* Flash media drive: high speed, uses bulk transfers, bus powered. 

* Keyboard: low speed HID. 

* Mouse: low speed HID. 
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* Seven hubs, consisting of five hubs that support all three bus speeds includ- 
ing one hub with multiple transaction translators and two hubs that sup- 
port low and full speeds only. 

The devices attach to the host in the configuration shown in Figure 17-6. Test 
labs can provide Gold Tree configurations. 

On attachment, the host must enumerate and install the driver for the device 
(with user assistance to identify the driver's location if appropriate). The device 
must operate properly while the other devices in the Gold Tree are also operat- 
ing. In addition, the device must continue to operate properly after each of 
these actions: 

* Detach the device and reattach it to the same port. 

* Detach the device and attach it to a different port. 

* Doa warm boot. (Start » Shutdown » Restart.) 

* Doa cold boot. (Start » Shutdown » Shutdown. Turn on the PC.) 


* When the device is active, place the system in the S1 Sleep state and 
resume. 


* When the device is idle, place the system in the S1 Sleep state and resume. 


e When the device is active, place the system in the S3 Sleep state and 
resume. 


A high-speed device must also be fully functional at full speed unless the 
USB-IF grants a waiver. The test specification has more details about the tests. 


Waivers 


A device can earn a USB Logo without passing every test. At its discretion, the 
USB-IF may grant a waiver of a requirement. For example, before the specifica- 
tion increased the limit for all devices, the USB-IF granted waivers to devices 
that drew up to 2.5 mA in the Suspend state. 


The Certified USB Logo 


A device that passes compliance testing is eligible to display the Certified USB 
logo. The logo also indicates if a device supports SuperSpeed, high speed, Certi- 
fied Wireless, and On-The-Go (Figure 17-7). To use the logo, you must sign 
the USB-IF Trademark License Agreement. If you're not a member of the 
USB-IF, you must pay a logo administration fee ($2000 at this writing). The 
logo is different from the USB icon described in Chapter 19. 
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Figure 17-6. Compliance testing uses this Gold Tree configuration for testing 
how a device behaves in a system where other USB devices are in use. 
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Figure 17-7. Devices that pass compliance testing can display a Certified USB 
logo. The logo indicates if the device supports high speed SuperSpeed, 
On-The-Go, or Wireless USB as appropriate. (Images courtesy of the USB 
Implementers Forum.) 
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Microsoft licenses logos for display by qualifying products and their marketing 
materials. To earn the right to display a logo, the manufacturer must submit test 
logs that demonstrate that the product meets Microsoft’s standards for compat- 
ibility, reliability, and security. 

Benefits of a Windows logo include increased customer confidence in the prod- 
uct, the ability to distribute drivers via Windows Update, listing the product on 
Microsoft's Windows Marketplace, and inclusion in the Windows Logo d Prod- 
ucts List and Windows Server Catalog. 


Tests 


To qualify for a Windows logo, a USB device must pass a series of tests based on 
the USBCV tests from USB-IF. Other tests deal with device installation and for 
vendor-provided drivers, driver reliability. Devices such as printer, keyboard, 
and storage device have function-specific tests. 


Each Windows family (such as Windows Vista, Windows XP, Windows Server 
2008) has its own logo. Recent Windows editions support two logo versions. 
For example, under Windows Vista, products that meet baseline requirements 
can earn the Works with Windows Vista logo, while products that meet more rig- 
orous requirements for ease of use, performance, and security can earn the Cer- 


tified for Windows Vista logo. 


Standard device functions each have a logo program with function-specific 
requirements. Devices that dont fit a category with a logo program cant display 
a Windows logo, but the manufacturer can submit the driver to Microsoft's 
Unclassified Signature program to obtain a digital signature. A submitted driver 
must pass tests on both 32-bit and 64-bit Windows editions. 


The Windows Logo Kit (WLK) is a set of tools that developers can use to test 
devices and drivers on Windows. The kit is a free download from Microsoft. 


Obtaining a license to display a Windows logo requires following these steps: 
1. Download the WDK and WLK from Microsoft. 


2. Obtain a code-signing ID and set up an organizational account with 
Microsofts Windows Quality Online Services (Winqual) program. One form 
of code-signing ID is a Microsoft Authenticode Code Signing Digital ID. This 
ID is a digital certificate that a manufacturer can also use to sign driver files as 
described later in this chapter. A lower cost option is a VeriSign Organizational 
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Certificate, which enables opening a Winqual account but isn’t valid for use 
with hardware products or for driver signing. 


3. Use the Driver Test Manager (DTM) software in the WLK to perform the 
required tests and generate a submission package with test results. The product 
manufacturer must perform all tests either in house or by contracting with a 
test lab. You don’t send the product to Microsoft. 


4, When the product has passed the required tests, submit the package created 
by the DTM to Winqual. Winqual also requires a product name and a signed 
logo license agreement. On receiving approval, the product and its marketing 
materials are licensed to display the logo(s) applied for. 


At this writing, the fee to set up a Winqual account is $250, and the fee to sub- 
mit a product for logo licensing is $250. Each Windows family requires a sepa- 
rate submission fee. These fees are in addition to the fee to obtain a 
code-signing ID. 


Digital Signatures 


A digital signature for a driver enables Windows to verify that the driver files 
haven't been modified since the driver was signed and to identify the source, or 
publisher, of the driver. The digital signature is a data set contained in a catalog 
(.cat) file associated with the driver or embedded in the driver itself. 


Microsoft or another certification authority (CA) issues a digital signature when 
a driver passes WHQL testing. For drivers that haven't passed WHQL testing, a 
vendor with an Authenticode Code Signing Digital ID can sign a driver using 
Microsoft free Sign Tool utility. 


A devices INF file can name a catalog file. Each INF file has its own catalog 
file, and one INF file can support multiple devices. Any change in an INF file, 
including adding a new Product ID or device release number, requires obtain- 
ing a new digital signature. 


Recent Windows editions store information relating to digital signatures in two 
databases called certificate stores. The Trusted Publishers certificate store con- 
tains information about the Authenticode certificates of publishers whose driv- 
ers are trusted. Users with administrative access can add publishers to this store. 
The Trusted Root Certification Authorities certificate store contains informa- 
tion about CAs that have met Microsoft's requirements. Users with administra- 
tive access can add private CAs to this store. 
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Whether a driver installs on a system depends on the Windows edition, the sys- 
tem’s security settings, whether the person installing the driver has administra- 
tive access, and whether the driver is signed. If the driver is signed, successful 
installation can depend on the source of the signature, whether the driver pub- 
lisher’s certificate is in the system’s Trusted Publishers certificate store, and 
whether the CA that issued the publisher's certificate is in the Trusted Root 
Certification Authorities certificate store. 


The 64-bit Windows editions require signed drivers. The 32-bit Windows edi- 
tions will install unsigned drivers but may display warnings depending on sys- 
tem settings. Under Windows Vista, only users with administrative access can 
install unsigned drivers. 


A driver signed by the Windows logo program installs without triggering secu- 
rity warnings. For other signed drivers, a dialog box with a security warning 
may appear if the driver publisher’s certificate isn’t in the computer’s Trusted 
Publishers certificate store. In the dialog box, selecting the option to always 
trust software from the publisher adds that publisher to the system’s Trusted 
Publishers certificate store. 
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Understanding how data is encoded on the bus can help in understanding the 
capabilities and limits of devices. This chapter presents the essentials of the 
USB’s encoding and data formats for USB 2.0 and SuperSpeed. 


USB 2.0 


Low 


The USB 2.0 specification defines bus states that correspond to signal voltages 
on the bus or conditions that the voltages signify. Different cable segments may 
be in different bus states. For example, in response to a request from the host, a 
hub might place one of its downstream ports in the Reset state while its other 
ports are in the Idle state. Low/full speed and high speed each have different 
defined bus states, though with many similarities. 


Speed and Full Speed Bus States 


Low and full speed support the same bus states, though some are defined differ- 
ently depending on the speed of the cable segment. A low-speed segment is a 
segment between a low-speed device and its nearest hub. A full-speed segment 
is any other segment that carries data at low- or full-speed bit rates. 
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Differential O and Differential 1 

When transferring data, the two states on the bus are Differential 0 and Differ- 
ential 1. A Differential 0 exists when D+ is a logic low and D- is a logic high. A 
Differential 1 exists when D+ is a logic high and D- is a logic low. Chapter 19 
has details about the voltages. 

The Differential 0/1s don’t translate directly into zero and one data states but 
instead indicate either a change in logic level, no change in logic level, or a bit 
stuff, as explained later in this chapter. 


Single-ended O 


The Single-ended 0 (SEO) state occurs when both D+ and D- are logic low. The 
bus uses the SEO state when entering the EOP, Disconnect, and Reset states. 


Single-ended 1 


The complement of SEO is the Single-ended 1 (SEI). This state occurs when 
both D+ and D- are logic high. This is an invalid bus state and should never 
occur except as specified in the USB battery-charging specification. 


Data J and Data K 


In addition to the Differential 0 and Differential 1 states, which are defined by 
voltages on the lines, USB also defines two Data bus states, J and K. These are 
defined by whether the bus state is Differential 0 or Differential 1 and the speed 
of the cable segment: 


Bus State Data State 

Low Speed |Full Speed 
Data J Data K 
Data K Data J 





Differential 0 
Differential 1 








Defining the J and K states in this way makes it possible to use one terminology 
to describe an event or logic state even though the voltages on low- and 
full-speed lines differ. For example, a Start-of-Packet state exists when the bus 
changes from Idle to the K state. On a full-speed segment, the state occurs 
when D- becomes more positive than D+, while on a low-speed segment, the 
state occurs when D+ becomes more positive than D-. 
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Idle 


In the Idle state, no drivers are active. On a full-speed segment, D+ is more pos- 
itive than D-, while on a low-speed segment, D- is more positive than D+. 
Shortly after device attachment, a hub determines whether a device is low or 
full speed by checking the voltages on the Idle bus at the device’s port. 


Resume 


When a device is in the Suspend state, a Data K state at the device’s port signi- 
fies a resume from Suspend. 


Start-of-Packet 


The Start-of-Packet (SOP) bus state exists when the lines change from the Idle 
state to the K data state. Every transmitted low- or full-speed packet begins with 
an SOP. 


End-of-Packet 


The End-of-Packet (EOP) state exists when a receiver has been in the SEO state 
for at least one bit time followed by a Data J state for at least one bit time. A 
receiver may optionally accept a shorter minimum time for the Data J state. At 
the driver, an SEO is approximately two bit widths. Every transmitted low- or 
full-speed packet ends with an EOP. 


Disconnect 


A downstream port is in the Disconnect state when an SEO has persisted for at 
least 2.5 us. 


Connect 


A downstream port enters the Connect state when the bus has been in the Idle 
state for at least 2.5 us and no more than 2.0 ms. 


Reset 


When an SEO has lasted for 10 ms, the device must be in the Reset state. A 
device may enter the Reset state after an SEO of at least 2.5 us. A full-speed 
device that is capable of high-speed communications performs the high-speed 
handshake during the Reset state. 
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On exiting the Reset state, a device must be operating at its correct speed and 
must respond to communications directed to the default address (00h). 


High Speed Bus States 
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Many of the high-speed bus states correspond to states for low and full speed, 
but a few are unique to high speed, and some low/full-speed states have no 
equivalents at high speed. 


High-speed Differential O and Differential 1 

The two bus states that exist when transferring high-speed data are High-speed 
Differential 0 and High-speed Differential 1. As with low and full speeds, a 
High-speed Differential 0 exists when D+ is a logic low and D- is a logic high, 
and a High-speed Differential 1 exists when D+ is a logic high and D- is a logic 
low. The voltage requirements differ at high speed, however, and high speed has 
additional requirements for AC differential levels. 


High-speed Data J and Data K 


The definitions for High-speed Data J and Data K states are identical to those 
for full-speed J and K. 


Bus State Data State (high speed) 
DifferentialO |High-speed Data K 
Differential 1 |High-speed Data J 





Chirp J and Chirp K 


The Chirp J and Chirp K bus states are present only during the high-speed 
detection handshake. The handshake occurs when a USB 2.0 hub has placed a 
downstream bus segment in the Reset state. In a Chirp J, D+ is more positive 
than D-, and in a Chirp K, D- is more positive than D+. 


A high-speed device must use full speed on attaching to the bus. The 
high-speed detection handshake enables a high-speed device to tell a USB 2.0 
hub that the device supports high speed and to transition to high-speed com- 
munications. 

As Chapter 4 explained, shortly after detecting device attachment, a device’s 
hub places a device’s port and bus segment in the Reset state. When a 
high-speed-capable device detects the Reset, the device places its line in the 
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Chirp K state for 1-7 ms. A hub that communicates upstream at high speed 
detects the Chirp K and in response, sends an alternating sequence of Chirp K 
and Chirp J. The sequence continues until shortly before the Reset state ends. 
On detecting the Chirp K and Chirp J sequence, the device disconnects its 
full-speed pull-up, enables its high-speed terminations, and enters the Default 
state. A hub that communicates upstream at low/full speed ignores the device's 
Chirp K. The device doesn’t see the answering sequence and knows that com- 
munications must take place at full speed. 


High-speed Squelch 
The High-speed Squelch state indicates an invalid signal. High-speed receivers 


must include circuits that detect the Squelch state, indicated by a differential 
bus voltage of 100 mV or less. 


High-speed Idle 
In the High-speed Idle state, no high-speed drivers are active and the 


low/full-speed drivers assert SEO. Both D+ and D- are between -10 and +10 
mV. 


Start of High-speed Packet 


A Start-of-High-speed Packet (HSSOP) exists when a segment changes from 
the High-speed Idle state to the High-speed Data K state. Every high-speed 
packet begins with a Start of High-speed Packet. 


End of High-speed Packet 


An End of High-speed Packet (HSEOP) exists when the bus changes from the 
High-speed Data K or Data J state to the High-speed Idle state. Every 
high-speed packet ends with an End of High-speed Packet. 


High-speed Disconnect 


Removing a high-speed device from the bus also removes the high-speed line 
terminations at the device. Removing the terminations causes the differential 
voltage at the hub’s port to double. A differential voltage of at least 625 mV on 
the data lines indicates the High-speed Disconnect state. A USB 2.0 hub con- 
tains circuits that detect this voltage. 
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Figure 18-1. In NRZI encoding, a 0 causes a change and a 1 causes no change. 
Bit stuffing adds a 0 after six consecutive 1s. 
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All data on a USB 2.0 bus is encoded using a format called non-return to zero 
inverted (NRZI) with bit stuffing. The encoding ensures that the receiver 
remains synchronized with the transmitter without the overhead of sending a 
separate clock signal or Start and Stop bits with each byte. 


If you use an oscilloscope or logic analyzer to view USB data on the bus, you'll 
find that reading the bits isn't as easy as matching voltage levels to logic levels. 
Instead of defining logic zeroes and ones as voltages, NRZI encoding defines 
logic zero as a voltage change, and logic one as a voltage that remains the same. 
Figure 18-1 shows an example. Each logic zero results in a change from the pre- 
vious state. Each logic one results in no change in the voltages. The bits trans- 
mit least-significant-bit first. 

Fortunately, USB hardware performs the encoding and decoding automatically 
so device developers and programmers dont have to do it. The encoded data is 
harder to interpret on an oscilloscope or logic analyzer, but as Chapter 17 
showed, a protocol analyzer will decode the data for you. 
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Staying Synchronized 


Unlike other interfaces, USB requires no Start and Stop bits or clock line in the 
cable. Instead, USB 2.0 synchronizes the sender and receiver by using bit stuff- 
ing and SYNC fields. Each of these adds some overhead, but the amount is 
minimal, especially with large packets. 


Bit Stuffing 


The encoding uses bit stuffing because the receiver synchronizes on transitions. 
Data that is all zeroes has plenty of transitions. But for data that contains a long 
string of Is, the lack of transitions could cause the receiver to get out of sync. 


After six consecutive 1s, the transmitter stuffs, or inserts, a zero (represented by 
a transition). The bit stuffing ensures at least one transition for every seven bit 
widths. The receiver detects and discards any bit that follows six consecutive 1s. 
The overhead for bit-stuffing in random data is just 0.896, or one stuff bit per 
125 data bits. 


SYNC Field 


Because devices and the host don’t share a clock, the receiver has no way of 
knowing exactly when a transmitter will send a transition that marks the begin- 
ning of a new packet. Thus, each packet begins with a SYNC field to enable the 
receiving device to align, or synchronize, its clock to the transmitted data. For 
low and full speeds, the SYNC pattern is eight bits: KJKJKJKK. The transition 
from Idle to the first K serves as a sort of Start bit that indicates the arrival of a 
new packet. 


For high speed, the SYNC pattern is 32 bits: fifteen KJ repetitions, followed by 
KK. A high-speed hub repeating a packet can drop up to four bits from the 
beginning of the sync field, so a SYNC field repeated by the fifth external hub 
in series can be as short as 12 bits. 


The alternating Ks and Js provide transitions for synchronizing, and the final 
two Ks mark the end of the field. After receiving the SYNC pattern, the receiv- 
ing device can accurately clock in the remaining bits in the packet. The price 
for synchronizing is adding 8 to 32 bit times to each packet. Large packets are 
thus much more efficient than smaller ones. 
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End of Packet 


An EOP returns the bus to the Idle state in preparation for the next SYNC 
field. The EOP signal is different for low/full and high speed. 


The low- or full-speed EOP is an SEO that lasts for two bit widths. 


At high speed, the signal is more complicated. High-speed receivers treat any 
bit-stuff error as an end of packet, so an HSEOP must cause a bit-stuff error. 


For all high-speed packets except SOFs, the HSEOP is an encoded byte of 
01111111 without bit stuffing. If the preceding bit was a J, the HSEOP is 
KKKKKKKK. The initial zero causes the first bit to be a change of state from J 
to K, and the following 1s mean that the rest of the bits don’t change. If the pre- 
ceding bit was a K, the HSEOP is JJJJJJJJ. The initial zero causes the first bit to 
be a change of state from K to J, and the following 1s mean that the rest of the 
bits don't change. In either case, the sequence of seven 1s causes a bit stuff error. 


In high-speed SOFs, the HSEOP is 40 bits. This longer packet allows a hub 
time to detect the doubled differential voltage that indicates that a device has 
been removed from the bus. The encoded byte begins with a zero, followed by 
39 ones, which results in an HSEOP consisting of 40 Js or 40 Ks. As with low 
and full speeds, this sequence results in a bit-stuff error that the receiver treats as 
an EOP. 


Timing Accuracy 
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One tradeoff of increased speed is stricter timing requirements. High speed has 
the strictest timing, while low speed is the most tolerant. These are the toler- 
ances for the clock at each speed: 








Speed Tolerance 
Low 1.5% 

Full 0.25% 
High 0.05% 





Devices typically derive their timing from a crystal. Many factors can affect a 
crystal’s frequency, including initial accuracy, capacitive loading, aging of the 
crystal, supply voltage, and temperature. Because of its wider tolerance, low 
speed can use inexpensive ceramic resonators instead of quartz crystals 


The signaling rate at a host or USB 2.0 hub must be within 0.05%, of the spec- 
ified rate at all speeds. The frame intervals must be accurate as well, at 1 ms 
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+500 ns per frame or 125.0 +62.5 us per microframe. Each hub has its own 
timing source and synchronizes its transmissions to the host's SOF signals in 
each frame or microframe. 


The USB specification also defines limits for data jitter, which is small varia- 
tions in the timing of the individual bit transitions. Factors that affect data jitter 
are differences in the rise and fall times of the drivers, clock jitter, and random 
noise. 


Packet Format 


As Chapter 2 explained, all USB 2.0 data travels in packets, which contain 
information in defined fields. Table 18-1 lists the fields that USB 2.0 packets 
contain and their purposes. 


SYNC 


Each packet begins with an 8-bit SYNC field, as described earlier. The SYNC 
Field serves as the Start-of-Packet delimiter. 


Packet Identifier 


The packet identifier field (PID) is 8 bits. Bits 3..0 identify the packet type and 
bits 7..4 are the complement of these bits for use in error checking. 


Chapter 2 introduced the PID codes for token, data, handshake and special 
packets. The lower two bits identify the PID type, and the upper two bits iden- 
tify the specific PID. 


Address 

The address field is seven bits that identify the device the host is communicat- 
ing with. 

Endpoint 


The endpoint field is four bits that identify an endpoint number within a 
device. 


Frame Number 


The frame-number field is eleven bits that identify the frame. The host sends 
this data in the SOF packet that begins each frame or microframe. After 7FFh, 
the number rolls over to zero. A full-speed host maintains an 11-bit counter 
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Table 18-1: USB 2.0 packets contain fields with defined contents. 


























Field Name Size (bits) Packet Types Purpose 
SYNC 8 Start of packet and 
synchronization 

PID 8 Identify the packet type 
Address 7 IN, OUT, Setup Identify the function address 
Endpoint 4 IN, OUT, Setup Identify the endpoint 
Frame Number |11 SOF Identify the frame 
Data 0 to 8192 (1024 bytes) |Data0, Datal Data 

for USB 2.0; 

0 to 8184 (1023 bytes) 

for USB 1.x 
Token CRC 5 IN, OUT, Setup Detect errors 
Data CRC 16 Data0, Datal Detect errors 








that increments once per frame. A high-speed host maintains a 14-bit counter 
that increments once per microframe. Only bits 3-13 of the microframe 
counter transmit in the frame number field, so the frame number increments 
once per frame, with eight microframes in sequence having the same frame 
number. 


Data 


The Data field may range from zero to 1024 bytes, depending on the transfer 
type, the bus speed, and the amount of data in the transaction. 


CRC 


The CRC field is 5 bits for address and endpoint fields and 16 bits for data 
fields. The transmitting hardware normally inserts the CRC bits and the receiv- 
ing hardware does the required error checking. 


Inter-Packet Delay 
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USB 2.0 carries data from multiple sources, in both directions, on one pair of 
wires. Data can travel in just one direction at a time. To ensure that the previ- 
ous transmitting device has had time to switch off its driver, the bus requires a 
brief delay between the end of one packet and the beginning of the next packet 
in a transaction. This delay is short, however, and devices must switch direc- 
tions quickly. 


Packets on the Bus 


The USB specification defines the delays differently for low/full and high 
speed. The delays are handled by hardware and require no support in code. 


Test Modes 


For use in compliance testing, the USB 2.0 specification adds five new test 
modes that all host controllers, hubs, and high-speed-capable devices must sup- 
port. 


An upstream-facing port enters a test mode in response to a Set Feature request 
with TEST_MODE in the wValue field. A downstream-facing port enters a 
test mode in response to the hub-class request Set Port Feature with 
PORT TEST in the wValue field. In both cases, the wIndex field contains the 
port number and the test number. All downstream ports on a hub with a port 
to be tested must be in the suspended, disabled, or disconnected state. 


An upstream-facing port exits the test mode when the device powers down and 
back up. A downstream-facing port exits the test mode when the hub is reset. 


These are the five test modes: 


Test J 
Value. 01h. 
Action. The transceiver enters and remains in the High-speed Data J state. 


Purpose. Test the high output drive level on D+. 


Test K 
Value. 02h. 
Action. The transceiver enters and remains in the High-speed Data K state. 


Purpose. Test the high output drive level on D-. 


Test SEO NAK 

Value. 03h. 

Action. The transceiver enters and remains in high-speed receive mode. 
Upstream-facing ports respond to IN token packets with NAK. 

Purpose. Test output impedance, low-level output voltage, and loading charac- 
teristics. Test device squelch-level circuits. Provide a stimulus-response test for 
basic functional testing. 
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Test Packet 
Value. 04h. 
Action. Repetitively transmit the test packet defined by the USB specification. 


Purpose. Test rise and fall times, eye pattern, jitter, and other dynamic wave- 
form specifications. 


Test Force Enable 

Value. 05h. 

Action. Enable downstream-facing hub ports in high-speed mode. Packets 
arriving at the upstream-facing port are repeated at the port being tested. The 
disconnect-detect bit can be polled while varying the loading on the port. 


Purpose. Measure the disconnect-detection threshold. 


Other Values 


Test-mode values 06h through 3Fh are reserved for future standard tests. Values 
CO-FFh are available for vendor-defined tests. All other values are reserved. 


SuperSpeed 


SuperSpeed’s fast, dual-simplex interface and new power-management capabili- 
ties require different encoding, packet formats, and low-level protocols. A 
SuperSpeed transmitter scrambles and encodes data to be sent on the bus. A 
SuperSpeed receiver decodes and de-scrambles the received data. 


Data Scrambling 


Data scrambling eliminates repetitive patterns in the data. Doing so spreads the 
radiated EMI over a wider frequency spectrum and helps in meeting FCC 
requirements. To scramble data to be transmitted, a free-running linear feed- 
back shift register implements a polynomial defined in the USB 3.0 specifica- 
tion. The transmitter XORs the output of the shift register with the data bits. 
Descrambling uses a complementary mechanism to recover the unscrambled 
data. 


Encoding 


SuperSpeed uses 8b/10b data encoding as specified in ANSI INCITS 
230-1994. Other interfaces that use this encoding include PCI Express, Gigabit 
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Packets on the Bus 


Ethernet and IEEE-1394b. The encoding converts each byte value to a 10-bit 
Data Symbol for transmitting. The encoded data has no more than five ones or 
zeroes in series and contains equal numbers of ones and zeroes over time. As 
with USB 2.0 data, frequent transitions enable the receiver to synchronize with 
the transmitted data without requiring a separate clock line. The roughly equal 
numbers of transmitted ones and zeroes provide DC balance, which prevents 
errors that could occur due to a DC component in the signal. The encoding 
also enables error detecting by monitoring the number of received ones and 
zeroes over time. 


Because the encoded data has more bits than the data being encoded, extra 
symbols are available to perform special functions. Data Symbols represent val- 
ues from 00h to FFh and Special Symbols perform functions used in framing 
data and managing link-level communications. 


The SuperSpeed signaling rate, or speed of the bits on the wires in each direc- 
tion, is 5 Gbps. The USB 3.0 specification refers to the rate as 5 GT/s 
(GigaTransfers per second). The 8b/10b encoding increases the number of bits 
to be transmitted by 25%, so 5 Gbps on the bus translates to 4 Gbps, or 500 
MB/s, of unencoded data. Framing, error detecting, and other protocols reduce 
the theoretical maximum data throughput to around 400 MB/s in each direc- 
tion. 


SuperSpeed links use low-frequency periodic signaling (LFPS) for exiting 
low-power states and performing Warm Resets. The signaling consists of bursts 
of a frequency for a specified time and repeat rate. The LFPS frequency is in the 
range 10-50 MHz, is easy to generate, and uses little power. 


Layer 


A SuperSpeed link is the physical and logical connection between two ports. 
The physical connection consists of a cable segment and the two ports, or link 
partners, the cable connects. The link partners manage the link by communi- 
cating via link commands and other signaling on the link when the wires arent 
carrying other traffic. Each port provides state machines and buffers to manage 
the connection and data transfers with the link partner. State machines generate 
link commands to acknowledge received header packets, recover from errors, 
implement flow control, and manage power on the link. An upstream-facing 
port must detect when its link has been idle for 10 us and send a special link 
command to indicate that the port is present. Link commands transmit when 
the link isn’t carrying Transaction Packets. Downstream-facing ports detect 
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device connection and removal and wakeup signaling. Link-layer protocols 
define how the link manages buffers, frames packets, and detects received pack- 
ets. The link layer also handles training and synchronizing to establish connec- 
tivity between a device (which may be a hub) and its upstream link partner. To 
synchronize, a link partner transmits defined series of bytes called Ordered Sets, 
which the receiving link partner detects. 


Reset 
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SuperSpeed defines two major categories of reset. A PowerOn Reset restores 
memory, registers, and other storage in the device to their default power-on 
states. An InBand Reset resets port settings and places the link in the UO state 
while remaining powered. Two types of InBand Reset are the Warm Reset and 
Hot Reset. A Warm Reset uses low frequency periodic signaling and takes 
around 100 ms. A Hot Reset uses link-level training sequences of Ordered Sets, 
is much faster, and leaves more settings unchanged in the device. 


The host requests an in InBand reset by issuing a hub-class Set Port Fea- 
ture(Port_Reset) or SetPortFeature(BH_Port_Reset) request to the hub that is 
the target devices link partner. On receiving a request for a BH. Port. Reset, the 
hub issues a Warm Reset to the device. On receiving a request for a Port. Reset, 
if the link is in U3, the hub uses a Warm Reset, and if the link is in UO, the hub 
uses a Hot Reset. For other states, the USB 3.0 specification defines how a hub 
decides which reset to use. 
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The Electrical and 
Mechanical Interface 


All of the protocols and program code in the world are no use if the signals 
dont make it down the wires in good shape. The electrical and mechanical 
interface play an important part in making USB a reliable way to transfer infor- 
mation. 

If you're using USB-compliant cables and components, you don’t need to know 
much about the electrical and mechanical interface. If you're designing 
printed-circuit boards with USB interfaces, you should understand the inter- 
faces and how they affect your projects circuits. 

This chapter presents the essentials about drivers and receivers and options for 
cables and connectors for USB 2.0 and USB 3.0. Those who want to go cable 
free will find a discussion of wireless options. 


USB 2.0 Transceivers 


The electrical signals on a USB 2.0 cable vary depending on the speed of the 
cable segment. Low-, full-, and high-speed signaling each use a different edge 
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rate, which is a measure of the rise and fall times of the voltages on the lines and 
thus the amount of time required for an output to switch. The transceivers and 
supporting circuits that produce and detect the bus signals also vary depending 
on speed. 


At any USB 2.0 speed, a transceiver must withstand the shorting of D+, D-, or 
both to GND, the other data line, or the cable shield at the connector. A 
requirement to withstand shorting to VBUS was reduced to a recommendation 
with the 5V Short Circuit Withstand Requirement Change ECN to the USB 2.0 
specification. Research showed that shorts to VBUS are extremely unlikely and 
that removing the requirement would allow reduced silicon area and power sav- 
ings on chips. 


Cable Segments 
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A cable segment connects a device (which may be a hub) to an upstream hub 
(which may be the root hub at the host). A segment’s speed depends on the 
speed of the end device and the speeds supported by the host and upstream 
hubs. Figure 19-1 illustrates. 


Low-speed segments exist only between low-speed devices and the hubs the 
devices’ cables connect to. A low-speed segment carries only low-speed data and 
uses low-speed’s edge rate and an inverted polarity compared to full speed. 


A full-speed segment exists when the segment’s downstream device communi- 
cates at full speed. When the downstream device is a hub, the segment may also 
carry data to and from low-speed devices that are downstream from the hub. In 
this situation, the low-speed data on the full-speed segment uses low-speed’s bit 
rate but full speed’s polarity and edge rate. The hub that connects to the 
low-speed device converts between low and full speed’s polarity and edge rates. 
Full-speed segments never carry data at high speed. A high-speed-capable device 
that connects to a USB 1.x hub communicates at full speed. 


High-speed segments exist when the host is USB 2.0 and all upstream hubs 
between the host and hub are USB 2.0. When the downstream device is a hub, 
the segment may also carry data to and from low- and full-speed devices that 
are downstream from the hub. All data in a high-speed segment travels at high 
speed, and the transaction translator in a downstream hub converts between 
low or full speed and high speed as needed. 

On attachment, all USB 2.0 devices must communicate at low or full speed. 
When possible, a high-speed-capable device transitions from full to high speed 
shortly after the device is attached, during the high-speed detection handshake. 


The Electrical and Mechanical Interface 








LOW-SPEED USB 1.X TO USB 1.X OR 
DEVICE p—M——————————À OR F— USB 2.0 HOST 
USB 2.0 HUB 








LOW-SPEED SEGMENT 








FULL-SPEED USB 1.X TO USB 1.X OR 
DEVICE OR [— USB 2.0 HOST 
USB 2.0 HUB 





FULL-SPEED SEGVENT 








HIGH-SPEED USB 1.X HUB TO USB 1.X OR 
DEVICE ee  S—<——] F— USB 2.0 HOST 








FULL-SPEED SEGVENT 
HIGH-SPEED DEVICES MUST RESPOND TO ENUVERATION REQUESTS AT FULL SPEED 











HIGH-SPEED USB 2.@ HUB 
DEVICE m TO USB 2.@ HOST 








HIGH-SPEED SEGVENT 

















|l EL 

É USB 1.X HUB USB 1.X TO USB 1.X OR 
EütL-sPeep C m OR I— USB 2.Ø HOST 
DEVICES =A USB 2.0 HUB 








FULL-SPEED SEGVENT 
ANY LOV- SPEED DATA USES LOW SPEED'S BIT RATE AND 
FULL SPEED'S POLARITY AND EDGE RATE 




















- USB 2.0 HUB USB 1.X HUB TO USB 1.X OR 
EULL-SPEED [— USB 2.0 HOST 
DEVICES 


FULL-SPEED SEGVENT 
ANY LOW- SPEED DATA USES LOW SPEED'S BIT RATE AND 
FULL SPEED'S POLARITY AND EDGE RATE 


i - USB 2.0 HUB USB 2.0 HUB 
B HIGH-SPEED |I— TO USB 2.0 HOST 
DEVICES 


HIGH-SPEED SEGVENT 
ANY LOW- OR FULL-SPEED DATA TRAVELS AT HIGH SPEED 












































Figure 19-1. The speed of data in a segment depends on the capabilities of the 
device and its upstream hub. 


Low- and Full-Speed Transceivers 


Transceivers for low and full speeds can have a simpler design compared to 
transceivers for high speed. 


Low- and Full-Speed Differences 


Low-speed data differs electrically from full-speed data in three ways. The bit 
rate is slower, at 1.5 Mbps compared to 12 Mbps for full speed. The polarity of 
low-speed traffic is inverted compared to full speed. And low speed has a slower 
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Li Vo 


ATA SENT BY A LOW-SPEED DEVICE TO ITS HUB USES 
PON- SPEED" S POLARITY AND SLOWER EDGE RATE. 






































THE SAVE DATA AT A USB 1.X HUB'S UPSTREAM-FACING 
PORT TRAVELS AT LOW SPEED BUT USES 
FULL-SPEED'S POLARITY AND FASTER EDGE RATE. 


Figure 19-2. a USB 1.x hub converts between low- and full-speed's polarities and 
edge rates. (Not drawn to scale.) 
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edge rate compared to full speed. Figure 19-2 illustrates. The slower edge rate 
reduces reflected voltages on the line and makes it possible to use cables that 
have less shielding and are thus cheaper to make and physically more flexible. 


The transceiver's hardware doesn’t care about the signal polarity. The transceiver 
just retransmits the logic levels at its inputs. A driver that supports both speeds, 
such as a driver for a hub’s downstream port, must switch between the two edge 
rates as needed. 


The Circuits 


Figure 19-3 shows port circuits and cable segments for low- and full-speed 
communications. Each transceiver contains a differential driver and receiver for 
sending and receiving data on the bus’s twisted pair. 


When transmitting data, the driver has two outputs that are 180 degrees out of 
phase: when one output is high, the other is low. A single driver can support 
both low and full speeds with an input that selects the edge rate. 


The differential receiver detects the voltage difference between the lines. A dif- 
ferential receiver has two inputs and defines logic levels in terms of the voltage 
difference between the inputs. The output of the differential receiver is also 
specified as a logic-high or logic-low voltage referenced to ground. 


Each port has two single-ended receivers that detect the voltages on D+ and D- 
with reference to signal ground. The logic states of the receivers’ outputs indi- 
cate whether the bus is low or full speed or whether the bus is in the SEO state. 
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Figure 19-3. The downstream-facing ports on a USB 1.x hub must support both 
low and full speeds (except for ports with embedded or permanently attached 
devices). A device's upstream-facing port supports one speed. (Adapted from 
Universal Serial Bus Specification Revision 2.0.) 
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The drivers’ output impedances plus a 36Q series resistor at each driver’s output 
act as source terminations that reduce reflected voltages when the outputs 
switch. The series resistors may be on-chip or external to the chip. 


Pull-up and Pull-down Values 


The pull-up resistor on D+ or D- at a device’s upstream-facing port enables the 
hub to detect the device’s speed. The hub’s downstream-facing port has 
pull-down resistors on D+ and D-. 


On devices with detachable cables, the pull-up resistors must connect to a posi- 
tive voltage of 3.0—3.6V. Devices with captive cables can instead use an alterna- 
tive means of termination, including connecting directly to VBUS. In selecting 
an alternatives means of termination, the designer must ensure that all signal 
levels meet the USB 2.0 requirements. 


The USB 2.0 Engineering Change Notice Pull-up/pull-down resistors loosens the 
tolerances for pull-up and pull-down resistors that connect to a voltage source 
of 3.0—3.6V. The original values were 1.5k +5% for the pull-ups and 15k +5% 
for the pull-downs. The tolerances were loosened to make it easier to include 
the resistors on chip without requiring laser trimming of the values. Using the 
looser tolerances increases complexity at upstream-facing ports because the 
device must switch between two pull-up values depending on whether the bus 
is in the idle or active state. But overall, the new tolerances can reduce cost to 
device manufacturers. Devices that use the original 1.5k pull-ups don’t have to 
switch values when switching between active and idle links. 


High-speed Transceivers 
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A high-speed device must support control-transfer requests at full speed, so the 
device must contain transceivers to support both full and high speeds and logic 
to switch between them. A high-speed-capable devices upstream-facing trans- 
ceivers arent allowed to support low speed. In an external USB 2.0 hub, the 
downstream transceivers at ports with user-accessible connectors must support 


all three speeds. 


Why 480 Megabits? 


High speed’s rate of 480 Mbps was chosen for several reasons. The frequency is 
slow enough to allow using the same cables and connectors as full speed. Com- 
ponents can use CMOS processes and don’t require the advanced compensation 
used in high-speed digital signal processors. Tests of high-speed drivers showed 
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20-30% jitter at 480 Mbps. Because receivers can be designed to tolerate 40% 
jitter, this bit rate allows a good margin of error. And 480 is an even multiple of 
12, so a single crystal can support both full and high speeds. 


The use of separate drivers for high speed makes it easy to add high speed to an 
existing full-speed design. Current-mode drivers were chosen because they’re 
fast. 


The Circuits 


Figure 19-4 shows upstream-facing transceiver circuits in a high-speed-capable 
device, and Figure 19-5 shows downstream-facing transceiver circuits in a USB 
2.0 hub. The USB 2.0 specification requires downstream-facing transceivers, 
and thus all compliant hosts and hubs, to support all three speeds. 


High speed requires its own drivers, so a high-speed device must contain two 
sets of drivers. For receiving, a transceiver may use a single receiver to handle all 
speeds or separate receivers for low/full speed and high speed. 


When a high-speed driver transmits data, a current source drives one line with 
the other line at ground. The current source may be active all the time or only 
when transmitting. A current source that is active all the time is easier to design 
but consumes more power. USB 2.0 requires devices to meet the signal-ampli- 
tude and timing requirements beginning with the first symbol in a packet, and 
this requirement complicates the design of a current source that is active only 
when transmitting. If the driver keeps its current source active all the time, the 
driver can direct the current to ground when not transmitting on the bus. 


In a high-speed-capable transceiver, the output impedance of the full-speed 
drivers has tighter tolerance compared to full-speed-only drivers (45Q +10%, 
compared to 36Q+22%). The high-speed bus uses the full-speed drivers as elec- 
trical terminations and requires new values for impedance matching. Full-speed 
drivers that arent part of a high-speed transceiver don’t require a change in out- 
put impedance. 


When the high-speed drivers are active, the full-speed drivers bring both data 
lines low (SEO state). Each driver and its series resistor then function as a 45Q 
termination to ground. Because each end of the cable segment has a driver, the 
line has a termination at both the source and the load. The double termination 
quiets the line more effectively than the source-only series terminations in 
full-speed segments. Using the full-speed drivers as terminations reduces the 
number of components. 
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Figure 19-4. The upstream-facing port on a high-speed device must also 
support full-speed communications. (Adapted from Universal Serial Bus 
Specification Revision 2.0.) 


The USB specification provides eye-pattern templates that show required 
high-speed transmitter outputs and receiver sensitivity. High-speed receivers 
must also meet new specifications that require the use of a differential 
time-domain reflectometer (TDR) to measure impedance characteristics. 


All high-speed receivers must include a differential envelope detector to detect 
the Squelch (invalid signal) state indicated by a differential bus voltage of 100 
mV or less. The downstream ports on all USB 2.0 hubs must also include a 
high-speed-disconnect detector that detects when a device has been removed 
from the bus. 
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Figure 19-5. The downstream-facing ports on USB 2.0 hubs must support all 
three speeds (except ports with embedded or permanently attached devices). 
(Adapted from Universal Serial Bus Specification Revision 2.0.) 


Other new responsibilities for high-speed-capable devices include managing the 
switch from full to high speed and handling new protocols for entering and 
exiting the Suspend and Reset states. 


Switching to High Speed 


In a low- or full-speed device, a pull-up on one of the signal lines indicates 
device speed. When a low- or full-speed device is attached or removed from the 
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bus, the voltage change due to the pull-up informs the hub of the change. 
High-speed-capable devices always attach at full speed, so hubs detect attach- 
ment of high-speed-capable devices in the same way. 


As Chapter 18 explained, the switch to high speed occurs after the device has 
been detected during the Reset initiated by the hub’s downstream port. A 
high-speed-capable device must support the high-speed handshake that informs 
the hub that the device is capable of high speed. When switching to high speed, 
the device removes its pull-up from the bus. 


Detecting Removal of a High-speed Device 


Because a device has no pull-up at high speed, the hub has to use a different 
method to detect device removal. Removing a device from the bus also removes 
the differential terminations, and the removal causes the differential voltage at 
the hub’s port to double. On detecting the doubled voltage, the hub knows the 
device is no longer attached. 


The hub detects the voltage by measuring the differential bus voltage during the 
extended End of High-speed Packet (HSEOP) in each high-speed 
Start-of-Frame Packet (HSSOP). A differential voltage of at least 625 mV indi- 


cates a disconnect. 


Suspending and Resuming at High Speed 


As Chapter 16 explained, USB 2.0 devices must enter the low-power Suspend 
state when the bus has been in the Idle state for at least 3 ms and no more than 
10 ms. When the bus has been idle for 3 ms, a high-speed device switches to 
full speed. The device then checks the state of the full-speed bus to determine 
whether the host is requesting a Suspend or Reset. If the bus state is SEO, the 
host is requesting a Reset, and the device prepares for the high-speed-detect 
handshake. If the bus state is Idle, the device enters the Suspend state. On exit- 
ing the Suspend state, the device resumes at high speed. 


Signal Voltages 
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Chapter 18 introduced USB’s bus states. The voltages that define the states vary 
depending on the speed of the cable segment. The difference in the specified 
voltages at the transmitter and receiver mean that a signal can have some noise 
or attenuation and the receiver will still see the correct logic level. 
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Table 19-1: High speed has different driver and receiver specifications 
compared to low and full speed. 


























Parameter Low/Full Speed (V) High Speed (V) 

VOUT low minimum 0 -0.010 

VOUT low maximum 0.3 0.010 

Vout high minimum 2.8 0.360 

VoUT high maximum 3.6 0.440 

VIN low maximum 0.8 Limits are defined by the 

VIN high minimum 2.0 eye-pattern templates in the 
í USB specification 





Low and Full Speeds 


Table 19-1 shows the driver output voltages for low/full and high speeds. At 
low and full speeds, a Differential 1 exists at the driver when the D+ output is at 
least 2.8V and the D- output is no greater than 0.3V, with both referenced to 
the driver's signal ground. A Differential 0 exists at the driver when D- is at least 
2.8V and D+ is no greater than 0.3V referenced to the driver's signal ground. 


At a low- or full-speed receiver, a Differential 1 exists when D+ is at least 2V 
referenced to the receiver's signal ground, and the difference between D+ and 
D- is greater than 200 mV. A Differential 0 exists when D- is at least 2V refer- 
enced to the receiver’s signal ground, and the difference between D- and D+ is 
greater than 200 mV. However, a receiver may optionally have less stringent 
definitions that require only a differential voltage greater than 200 mV, ignor- 
ing the requirement for one line to be at least 2V. 


High Speed 


At high speed, a Differential 1 exists at the driver when both the D+ output is at 
least 0.36V and the D- output is no greater than 0.01V referenced to the 
driver's signal ground. A Differential 0 exists at the driver when D- is at least 
0.36V and D+ is no greater than 0.01V referenced to the driver's signal ground. 


At a high-speed receiver, the input must meet the requirements shown in the 
eye-pattern templates in the USB 2.0 specification. The eye patterns specify 
maximum and minimum voltages, rise and fall times, maximum jitter in a 
transmitted signal, and the maximum jitter a receiver must tolerate. The speci- 
fication explains how to make the measurements. 
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Table 19-2: The requirements for cables and related components differ for 
full/high-speed cables and cables that attach to low-speed devices. 















































Specification Low Speed Full/High Speed 
Maximum length (typica) (m b = |s = 
Inner shield and drain wire required? yes (new in USB 2.0) |yes 

Braided outer shield required? no, but recommended [yes 

Twisted pair required? no, but recommended [yes 
Common-mode impedance (Q) not specified 30 +30% 
Differential Characteristic impedance (Q) not specified 90 

Cable skew (picoseconds) < 100 

Wire gauge (AWG) 28 or larger diameter 

DC resistance, plug shell to plug shell (Q) 0.6 

Cable delay 18 ns (one way) 5.2 ns/m 

pull-up location at the device D- D+ 

Detachable cable OK? no yes 

Captive cable OK? yes 








USB 2.0 Cables 


The USB specifications include cable and connector requirements that help 
ensure that signals will make it to their destinations without errors due to noise. 
The cable specifications also limit noise that radiates from the cable. 


Conductors 
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USB 2.0 cables provide conductors for power, ground, and USB 2.0 communi- 
cations. The cables contain wires for VBUS, ground, the D+ and D- signal 
wires, and a drain wire that connects to the cable shield (Table 19-3). Chapter 
16 detailed the voltage and current limits for VBUS. The signal wires carry the 
data. Unlike RS-232, which has a TX line to carry data in one direction and an 
RX line for the other direction, USB 2.05s pair of wires carries a single differen- 
tial signal, and data travels in one direction at a time. 


Cables for low-speed segments have different requirements than cables for full- 
or high-speed segments (Table 19-2). A low-speed segment is a cable segment 
between a low-speed device and its hub. Any additional upstream segments 
between hubs are considered full- or high-speed segments. A low-speed cable 
must have the same inner shield and drain wire required for full speed. The 
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Table 19-3: A USB 2.0 cable has four wires plus a drain wire. 

















Wire Name Use Color 
1 VBUS +5V Red 

2 GND Ground reference White 
3 D+ Signal pair positive Green 
4 D- Signal pair negative Black 
Shell Shield Drain wire - 














USB 2.0 specification also recommends, but doesn’t require, a braided outer 
shield and a twisted pair for data, as on full- and high-speed cables. The USB 
1.x specification required no shielding for low-speed cables. 


Full- and high-speed segments can use the same cables. In a full/high-speed 
cable, the signal wires must have a differential characteristic impedance of 90Q. 
This value is a measure of the input impedance of an infinite, open line and 
determines the initial current on the lines when the outputs switch. The charac- 
teristic impedance for a low-speed cable isn’t defined because the slower edge 
rates mean that the initial current doesnt affect the logic states at the receiver. 


The USB 2.0 specification lists requirements for the cable’s conductors, shield- 
ing, and insulation. These are the major requirements for full/high-speed 
cables: 


Signal wires: twisted pair, 28 AWG or larger diameter. 

Power and ground: non-twisted, 28 AWG or larger diameter. 

Drain wire: stranded, tinned copper wire, 28 AWG or larger diameter. 
Inner shield: aluminum metallized polyester 

Outer shield: braided, tinned copper or equivalent braided material 


The specification also lists requirements for the cable’s durability and perfor- 
mance. 


A low-speed device can use a full-speed cable if the cable meets all of the 
low-speed cable requirements including a maximum length of 3 m and not 
using a standard USB connector type at the device. 


Connectors 


USB 2.0 allows these options for the USB receptacle on a device: Standard B 
(also called Std B, Series B, or just “B”), Mini B, and Micro B. Figure 19-6 
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Figure 19-6. Approved cable plugs include (from left) Standard-A for hosts and 
Standard-B, Mini-B, and Micro-B for devices. 
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shows cable plugs that mate with these receptacles. Another option for devices 
is a captive cable, which uses a vendor-specific connector or is permanently 
attached to the device. 


USB 2.0 hosts use the Standard A (also called Std A, Series A or “A”) receptacle. 
USB On-The-Go products use Micro-AB receptacles, which can accept a cable 
with a Micro-A or Micro-B plug. Chapter 20 has more about On-The-Go con- 


nectors. 


The USB 2.0 specification defines the Standard series connectors. ECNs define 
the Mini and Micro series connectors. 


Mini and Micro plugs have an additional ID pin. On-The-Go devices use the 
ID pin to identify a devices default mode (host or function). Table 19-4 shows 
the pinout for the connectors. 


All of the connectors are keyed so you can't insert a plug the wrong way. The 
connections for D+ and D- are recessed so the power lines connect first on 
attachment. The USB icon can identify a USB plug or receptacle (Figure 19-7). 
A “+” indicates support for high speed. A receptacle should mount so the USB 
icon on the top of the plug is visible to users inserting a plug. 


Most devices have a single type-B connector. However, devices with multiple 
connectors are allowed. For example, a printer might have a port on the back to 
connect to a conventional host and a second port on the front to allow quick 
printing directly from a camera or portable computer. The USB-IF’s Embedded 
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Figure 19-7. The USB icon identifies a USB plug or receptacle. A “+” indicates 




















support for high speed. 
Table 19-4: The Mini-B and Micro-B receptacles have an additional 
pin for OTG products. 
Pin Standard A, Standard B Mini B, Micro B 
I |vBus ~~~... |vBOS | 
2 D- D- 
3 D+ D+ 
4 GND Open or >= 1MQ 
5 Not present GND 
Shell Shield Shield 











Hosts and/or Multiple Receptacles document specifies that a device with multiple 
type-B connectors is allowed if all ports support the same speeds, if each con- 
nector has a device controller that operates independently from other device 
controllers in the device, and if all ports can enumerate at the same time. 


Detachable and Captive Cables 


USB 2.0 defines cables as being either detachable or captive. From the names, 
you might think that a detachable cable is one you can remove while a captive 
cable is permanently attached to its device. In fact, a captive cable can be 
removable as long as its downstream connector is not one of the standard USB 
connector types. 


A detachable USB 2.0 cable must be full/high speed, with a Standard-A plug 
for the upstream connection and a Standard-B, Mini-B, or Micro-B plug for 
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the downstream connection. A captive cable may be low or full/high speed. The 
upstream end has a Standard-A plug. For the downstream connection, a captive 
cable can be permanently attached or removable with a non-standard connector 
type. The non-standard connection doesn’t have to be hot pluggable, but the 
Standard-A connection must be hot pluggable. Requiring low-speed cables to 
be captive eliminates the possibility of trying to use a low-speed cable in a full- 
or high-speed segment. 


USB On-The-Go products have other cable options as described in Chapter 
20. 


Cable Length 
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USB 1.0 specified maximum lengths for cable segments. A full-speed segment 
could be up to 5 m and a low-speed segment could be up to 3 m. USB 1.1 and 
later dropped the length limits in favor of a discussion of characteristics that 
limit a cable’s ability to meet timing and voltage specifications. On full- and 
high-speed cables, the limits are due to signal attenuation, cable propagation 
delay (the amount of time it takes for a signal to travel from driver to receiver), 
and voltage drops on the VBUS and GND wires. On low-speed cables, the 
length is limited by the rise and fall times of the signals, the capacitive load pre- 
sented by the segment, and voltage drops on the VBUS and GND wires. 


USB 1.05 limits of 3 m and 5 m are still good guidelines for cables with Stan- 
dard-B and Mini-B plugs. Compliant cables of these lengths are readily avail- 
able. Cables with Micro-B plugs have the special requirements of a a shorter 
maximum transmission delay (10 ns) and a resulting shorter maximum length 
of 2 m. 


The USB specifications prohibit extension cables that extend a segment by add- 
ing a second cable in series. An extension cable for the upstream side of a cable 
would have a Standard-A plug on one end and a Standard-A receptacle on the 
other, while an extension cable for the downstream side would have a B plug 
and receptacle. Prohibiting extension cables eliminates the temptation to 
stretch a segment beyond the interface’s electrical limits. Extension cables are 
available, but just because you can buy one doesn’t mean that it's a good idea or 
that the cable will work. Instead, to extend the distance between a host and 
device, use hubs. 


An exception is an active extension cable that contains a hub, a downstream 
port, and a cable. This type of cable works fine because it contains the required 
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hub. Depending on the attached device, the hub may need its own power sup- 
ply. 

An option for long distances is to use an adapter as a bridge that converts 
between USB and Ethernet, RS-485, or another interface suitable for longer 


distances. The remote device supports the long-distance interface rather than 
USB. 


Another approach enables accessing USB devices via a local Ethernet network. 
Two products that use this method are the AnywhereUSB hub from Digi Inter- 
national and the USB Server from Keyspan. The AnyWhereUSB hub contains 
one or more host controllers that communicate with the host PC over an Ether- 
net connection using the Internet Protocol (IP). The hub can attach to any 
Ethernet port in the PC’s local network. The host drivers for the USB devices 
are on the PC. PC applications can access many USB devices that connect to 
the AnywhereUSB hub and use bulk and interrupt transfers. The interface has 
increased latency due to the added protocol layer. The USB Server works in a 
similar way. 

Software-only products for accessing USB devices over a network are USB over 
Network from Fabula Tech and USB Redirector from Incentives Pro. To use 
these products to access a device attached to another computer in a network, 
you must install software on the PC the device attaches to and the PC(s) that 
will access the device. 


Bus Length 


A bus can have up to 5 external hubs in a tier. Thus, using 5 m cables, a device 
can be up to 30 m from its host. If the device is low speed, the limit is 28 m 
because the cable the connects to the low-speed device can be no more than 3 
m. The limit on the number of hubs is due to the electrical properties of the 
hubs and cables and the resulting delays in propagating signals along the cable 
and through a hub. 


Inter-Chip Connections 


USB was developed as an interface to connect computers and peripherals via 
cables. But USB has also found uses in products that contain a host and an 
embedded or removable peripheral. In these products, communications 
between the host and peripheral dont require standard USB cables or connec- 
tors and can use lower supply voltages. 


455 


Chapter 19 


Two USB-IF standards for this type of interface are the Jnter-Chip USB Supple- 
ment for low and full speeds and the High-Speed Inter-Chip USB Electrical Spec- 
ification for high speed. 

For both interface types, all of the following are true: 

* The distance between the host and peripheral is 10 cm or less. 

* The host doesnt allow peripheral attachment or removal while the 
inter-chip supply voltage is present. 

* The interface can use a vendor-specific cable or on-board connection (cir- 
cuit-board traces). 

An interface that complies with the Inter-Chip USB Supplement must meet 
these requirements: 

* The host always supports full speed and supports low speed if the host com- 
municates with a low-speed peripheral. The peripheral may support low or 
full speed. 

* The interface supports one or more of six defined supply-voltage classes 
with nominal voltages in the range 1—3V. 

The low/full speed interface draws no bus current when idle. To save additional 
power, hardware can switch out the bus pull-up and pull-down resistors during 
traffic signaling. 
The High-Speed Inter-Chip USB Electrical Specification defines an interface 
that uses a high-speed inter-chip (HSIC) synchronous serial interface. The 
interface uses 240-MHz double data rate (DDR) signaling, which transfers data 
on both the rising and falling clock edges. A 240-Mhz clock thus supports a 
480-Mbps bit rate. 
An interface that complies with the High-Speed Inter-Chip USB Electrical 
Specification must meet these requirements: 

* The host and peripheral support high speed. 

* The interface uses 1.2V LVCMOS voltages. 


The HSIC interface consumes power only when a transfer is in progress. 


USB 3.0 
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To support SuperSpeed, USB 3.0 adds transmitters and receivers and modifies 
the cables and connectors to carry the SuperSpeed signals. 


The Electrical and Mechanical Interface 


Transmitters and Receivers 


For SuperSpeed, each direction has a dedicated pair of wires with a differential 
transmitter at one end and a differential receiver at the opposite end. The hard- 
ware interface is based on the PCI Express (PCIe) Gen 2 interface used in 
expansion buses in PCs. In a PC, the bus uses multiple lanes to transfer multi- 
ple bits in the same direction at once. SuperSpeed uses a single lane with one 
signal pair for each direction. 


A SuperSpeed transmitter must contain a circuit that detects an attached 
receiver's load of 18-300. An RC charging circuit can perform this function. 
Because the SuperSpeed wires carry data at a single speed, an upstream hub that 
detects a SuperSpeed device knows the device's speed. 


Cables 


USB 3.0 cables can carry both USB 2.0 and SuperSpeed traffic. The cables have 
additional wires and connector contacts to support SuperSpeed. 


Compatibility 
USB 3.0 cables and connectors are backwards compatible with USB 2.0. Plugs 


on USB 2.0 cables fit USB 3.0 receptacles. A USB 2.0 cable attached to a USB 
3.0 host or hub can carry low-, full-, and high-speed data. 


A USB 3.0 Standard-A plug fits a USB 2.0 Standard-A receptacle. Thus you 
can use a USB 3.0 cable to attach a USB 3.0 device to a USB 2.0 host or hub 
and communicate at a USB 2.0 speed. Attaching a USB 2.0 device to a USB 
3.0 host or hub requires a USB 2.0 cable. USB 3.0 Standard-B and USB 3.0 
Micro-B plugs dont fit USB 2.0 receptacles. 


To use SuperSpeed, all cables and receptacles in the links between the device 
and host must be USB 3.0. 


Conductors 


A USB 3.0 cable has ten wires (Table 19-5), which include USB 2.0’s power, 
ground, and unshielded pair plus two shielded pairs with drain wires for Super- 
Speed. The SuperSpeed interface is dual simplex: each direction has its own pair 
of wires, each pair has its own ground, or drain, wire, and data can travel in 
both directions at once. (Full duplex is also bidirectional but uses a single, com- 
mon ground wire.) The SuperSpeed wires can be shielded twisted pairs or twi- 
naxial cable (twinax). Twinax is similar to coax but has two inner conductors 
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Table 19-5: A USB 3.0 cable has additional wires to support SuperSpeed 
































Wire |Name at Use Color 
Connector 

1 PWR VBUS power Red 

2 UTP_D- Unshielded differential pair, negative (USB 2.0) White 

3 UTP_D+ Unshielded twisted pair, positive (USB 2.0) Green 

4 GND_PWRrt Ground for power return Black 

5 SDPI- Shielded differential pair,1, negative (SuperSpeed) |Blue 

6 SDP1+ Shielded differential pair 1, positive (SuperSpeed) Yellow 

7 SDP1_Drain Drain wire for SDP1. - 

8 SDP2- Shielded differential pair 2, negative (SuperSpeed) — |Purple 

9 SDP2+ Shielded differential pair 2, positive (SuperSpeed) Orange 

10 SDP2_Drain Drain wire for SDP2. Connects to pin 7 on the - 

connectors. 
Braid [Shield External braid terminated onto metal shell of plug |- 
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instead of one. The characteristic impedance of shielded twisted pairs should be 
90Q. 


USB 3.0 doesn't specify wire gauges but provides electrical data for typical val- 
ues (26-34 AWG) and recommends using the smallest-diameter gauges that 
meet the electrical requirements of the cable assembly. Cable flexibility, which 
generally decreases with the AWG number, may also be a consideration. The 
cable's outer diameter must be in the range 3-6 mm. 


Connectors 


USB 3.0 connectors have five additional contacts for the two SuperSpeed signal 
pairs and the two drain wires, which terminate at the same pin. Figure 19-8 
shows the connectors. 


Table 19-6 shows which plugs can attach to different receptacle types. A USB 
3.0 device can have a USB 3.0 Standard-B or USB 3.0 Micro-B receptacle, a 
captive cable with a USB 3.0 Standard-A plug, or the USB 3.0 Powered-B con- 
nector described below. A USB 3.0 host has a USB 3.0 Standard-A receptacle. 

Except for the Mini-B, all USB 2.0 plugs can mate with a USB 3.0 receptacle of 


the same series. A USB 2.0 Standard-A plug fits a USB 3.0 Standard-A recepta- 
cle, a USB 2.0 Standard-B plug fits a USB 3.0 Standard-B receptacle, and a 
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USB 3.0 STANDARD-B PLUG USB 3.0 MICRO-B PLUG 


Figure 19-8. USB 3.0 connectors have additional contacts for the SuperSpeed 
wires. (Not drawn to scale.) 


Table 19-6: USB 3.0 connectors are backwards compatible with USB 2.0 


connectors. 























Unit Connector Mates with 
USB 2.0 host USB 2.0 Standard-A receptacle USB 2.0 Standard-A plug 
USB 3.0 host USB 3.0 Standard-A receptacle USB 3.0 Standard-A plug 
USB 2.0 device |USB 2.0 Standard-B receptacle USB 2.0 Standard-B plug 
USB 2.0 Mini-B receptacle USB 2.0 Mini-B plug 
USB 2.0 Micro-B receptacle USB 2.0 Micro-B plug 
Captive cable with USB 2.0 USB 2.0 Standard-A receptacle 
Standard-A plug USB 3.0 Standard-A receptacle 
USB 3.0 device |USB 3.0 Standard-B receptacle USB 2.0 Standard-B plug 





USB 3.0 Powered-B receptacle 


USB 3.0 Standard-B plug 
USB 3.0 Powered-B plug 





USB 3.0 Micro-B receptacle 


USB 2.0 Micro-B plug 
USB 3.0 Micro-B plug 








Captive cable with USB 3.0 





USB 2.0 Standard-A receptacle 


USB 3.0 Standard-A receptacle 


Standard-A plug 
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SS] 


Figure 19-9. The plugs on compliant USB 3.0 cables should display the USB 3.0 
icon. (Image courtesy of the USB Implementers Forum.) 
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USB 2.0 Micro-B plug fits a USB 3.0 Micro-B receptacle. There is no USB 3.0 
Mini-B receptacle. Of course, cables with USB 2.0 plugs can’t carry SuperSpeed 
traffic. 


The USB 3.0 Standard-A plug and receptacle have the same form factors as the 
USB 2.0 Standard-A plug and receptacle. Thus a USB 3.0 Standard-A plug will 
mate with a USB 2.0 Standard-A receptacle. To support SuperSpeed, USB 3.0 
Standard-A connectors use a 2-tier contact system with five additional contacts 
that lie behind the four USB 2.0 contacts on the plug. 


Compliant USB 3.0 cables should display the USB 3.0 icon (Figure 19-9). The 
USB 3.0 specification recommends using Pantone 300 blue for the internal 
plastic housing on Standard-A connectors. The connector’s outer shell can be 
any color. 


Powered-B Connector 


Under USB 2.0, Wireless USB adapters that connect to USB devices must pro- 
vide their own power. USB 3.0’s Powered-B connectors enable these and similar 
adapters to draw power from a device even when the device isn't configured or 
the link is in the Suspend state. The device must have a Powered-B receptacle, 
which has two extra contacts that can provide 5V at up to 1A to a connected 
adapter or other device. The adapter to be powered must have a permanently 
attached cable with a Powered-B plug. If the device instead uses a wired connec- 
tion to a host or hub, the Powered-B contacts are unused. The Powered-B plug 
also fits a USB 3.0 Standard-B receptacle, so an adapter that supports self power 
can attach to devices that don’t use the Powered-B contacts. 
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Table 19-7: USB 3.0 defines a host-to-host cable for SuperSpeed traffic. 























USB 3.0 Standard-A Pin | Signal USB 3.0 Standard-A Pin 
1-3  |noconnet |-3 
4 GND 4 
5 SDPI- 8 
6 SDP1+ 9 
7 SDP1_Drain and 7 
SDP2_Drain 
8 SDP2- 5 
9 SDP2+ 6 











Cable Length 


USB 3.0 doesn’t specify a maximum cable length. For VBUS and GND, the 
specification provides a table that suggests maximum lengths for different AWG 
values to meet voltage-drop limits. A 3-m cable requires 22 AWG or larger diam- 
eter PWR and GND wires. For the signal wires, the specification defines limits 
for differential insertion loss, which is a measure of how much a signal degrades 
as it passes through a cable assembly. To comply with these limits, the signal 
wires in a 3-m cable must use 26 AWG or larger diameter wires. 


Bus Length 


Like USB 2.0, USB 3.0 allows five external hubs in a tier. A typical USB 3.0 
cable is 3 m, so a typical maximum SuperSpeed bus length is 18 m. USB 2.0 
devices can continue to use 5 m USB 2.0 cables with USB 3.0 hosts and hubs. 


Host-to-Host Cables 


USB 2.0 forbids cables that connect two hosts except for bridge cables that con- 
tain device controllers with a shared buffer. USB 3.0 defines a USB 3.0 Stan- 
dard-A to USB 3.0 Standard-A cable for debugging and other specialized 
host-to-host applications with driver support. The cable is a crossover cable for 
the SuperSpeed lines (Table 19-7). VBUS, D-, and D+ have no connection. 


Ensuring Signal Quality 


The USB specifications for drivers, receivers, and cable design ensure that virtu- 
ally all data transfers occur without errors. Requirements that help to ensure 
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signal quality include the use of balanced lines and shielded cables, twisted pairs 
(required for full/high-speed), and slower edge rates for low-speed drivers. 


Sources of Noise 


Noise can enter a wire in many ways, including by conductive, com- 
mon-impedance, magnetic, capacitive, and electromagnetic coupling. If a noise 
voltage is large enough and is present when the receiver is reading a transmitted 
bit, the noise can cause the receiver to misread the transmitted logic level. Very 
large noise voltages can damage components. 


Conductive and common-impedance coupling require ohmic contact between 
the signal wire and the wire that is the source of the noise. Conductive coupling 
occurs when a wire brings noise from another source into a circuit. For exam- 
ple, a noisy power-supply line can carry noise into the circuit the supply pow- 
ers. Common-impedance coupling occurs when two circuits share a wire, such 
as a ground return. 


The other types of noise coupling result from interactions between the electric 
and magnetic fields of the wires themselves and signals that couple into the 
wires from outside sources, including other wires in the interface. Capacitive 
and inductive coupling can cause crosstalk, where signals on one wire enter 
another wire. Capacitive coupling, also called electric coupling, occurs when 
two wires carry charges at different potentials, resulting in an electric field 
between the wires. The strength of the field and the resulting capacitive cou- 
pling varies with the distance between the wires. Inductive, or magnetic, cou- 
pling occurs because current in a wire causes the wire to emanate a magnetic 
field. When the magnetic fields of two wires overlap, the energy in each wire's 
field induces a current in the other wire. When wires are greater than 1/6 wave- 
length apart, the capacitive and inductive coupling are considered together as 
electromagnetic coupling. An example of electromagnetic coupling is when a 
wire acts as a receiving antenna for radio waves. 


Balanced Lines 
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One way USB eliminates noise is with the balanced lines that carry the differen- 
tial signals. On balanced lines, noise that couples into the interface is likely to 
couple equally into both signal wires. At a differential receiver, which detects 
only the difference between the two wires' voltages, any noise that is common 
to both wires cancels out. 
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Figure 19-10. A full/high-speed USB cable contains a twisted pair for data, 
VBUS and GND wires, and aluminum metallized polyester and braided copper 
shields. 


In contrast, in the unbalanced, single-ended lines that RS-232 and other inter- 
faces use, the receiver detects the difference between a signal wire and a ground 
line shared by other circuits. The ground line is likely to be carrying noise from 
a number of sources, and the receiver sees this noise when it detects the differ- 
ence between the signal voltage and ground. 


Twisted Pairs 


In a full/high-speed USB cable, the signal wires must be a twisted pair. Twisted 
pairs are also recommended for low-speed cables. A twisted pair is two insulated 
conductors that spiral around each other with a twist every few inches (Figure 
19-10). The twisting reduces noise by reducing the amount of noise in the 
wires and by canceling noise that enters the wires. Twisting is most effective at 
eliminating low-frequency, magnetically coupled signals such as 60-Hz 
power-line noise. 

Twisting reduces noise by minimizing the area between the conductors. The 
magnetic field that emanates from a circuit is proportional to the area between 
the conductors. Twisting the conductors around each other reduces the total 
area between them. The tighter the twists, the smaller the area. Reducing the 
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area shrinks the magnetic field emanating from the wires and thus reduces the 
amount of noise coupling into the field. 


A twisted pair tends to cancel any noise that enters the wires because the con- 
ductors swap physical positions with each twist. Any noise that magnetically 
couples into the wires reverses polarity with each twist. The result is that the 
noise present in one twist is cancelled by a nearly equal, opposite noise signal in 
the next twist. Of course, the twists arent perfectly uniform and the canceling 
isn't perfect, but noise is much reduced. 


Shielding 


Metal shielding prevents noise from entering or emanating from a cable. Shield- 
ing is most effective at blocking noise due to capacitive, electromagnetic, and 
high-frequency magnetic coupling. USB 2.0 requires both low-speed and 
full/high-speed cables to be shielded, though the requirements differ. 


In a full/high-speed cable, an aluminum metallized polyester shield surrounds 
the four conductors. Around this shield is an outer shield of braided, tinned 
copper wire. Between the shields and contacting both is a copper drain wire. 
The outside layer is a polyvinyl chloride jacket. The shield terminates at the 
connector plug. 


A low-speed cable has the same requirements except that the braided outer 
shield is recommended but not required. USB 1.x required no shielding for 
low-speed cables on the premise that the slower rise and fall times made shield- 
ing unnecessary. The shielding requirement was added in USB 2.0 not because 
the USB interface is noisy in itself, but because the cables are likely to attach to 
computers that are noisy internally. Shielding helps keep the cable from radiat- 
ing this noise and thus helps with passing FCC tests. The downside is that USB 
2.0 low-speed cables are more expensive to make and physically less flexible. 
USB 2.0 uses unshielded twisted pairs, but USB 3.0 requires shielding around 
each SuperSpeed signal pair and its drain wire. USB 3.0 cables must also have 
metal braid surrounding all of the wires and terminating at the metal shell. 


Edge Rates 
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Because of low speed’s slower data rate, drivers can use slower edge rates that 
reduce reflected voltages seen by receivers and noise that emanates from the 
cable. 


When a digital output switches, a mismatch between the line’s characteristic 
impedance and the load presented by the receiver can cause reflected voltages 
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that affect the voltage at the receiver. If the reflections are large enough and last 
long enough, the receiver may misread a transmitted bit. 


In low-speed cables, the slower edge rate ensures that any reflections have died 
out by the time the output has finished switching. The slow edge rate also 
means that the signals contain less high-frequency energy and thus the noise 
emanated by the cables is less. 


Isolated Interfaces 


Galvanic isolation can be useful in preventing electrical noise and power surges 
from coupling into a circuit. Circuits that are galvanically isolated from each 
other have no ohmic connection. Typical methods of isolation include using a 
transformer to transfer power by magnetic coupling and optoisolators to trans- 
fer digital signals by optical coupling. 

USB devices shouldn't require isolation in conventional environments such as 
offices and classrooms. For industrial environments or other locations where 
devices might benefit from isolation, USB's timing requirements and USB 2.0's 
use of a single pair of wires for both directions make it difficult to isolate a 
device from its host. One solution is to isolate the non-USB components the 
device controller connects to. For example, in a motor controller with a USB 
interface, the motor and control circuits can be isolated from the USB control- 
ler and bus. 


Another option is to use an isolated hub. B & B Electronics and Sealevel Sys- 
tems offer hubs with isolated low/full-speed downstream ports. 


Going Wireless 


Replacing a USB cable with a wireless connection isn't a simple task. USB trans- 
actions involve communicating in both directions with tight timing require- 
ments. For example, when a USB 2.0 host sends a token and data packet in the 
Data stage of an interrupt OUT transaction, the device must respond quickly 
with ACK or another code in the handshake packet. 


But the idea of a wireless connection for USB devices is so compelling that mul- 
tiple technologies have become available to incorporate USB in wireless appli- 
cations. In many implementations, the wireless links use wired devices that 
serve as wireless bridges, or adapters. The bridge uses USB to communicate 
with the host and a wireless interface to communicate with the peripheral. The 
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peripheral contains a wireless bridge to convert between the wireless interface 
and the peripheral’s circuits. 


Certified Wireless USB 


The USB-IF Wireless Universal Serial Bus Specification defines Certified Wire- 
less USB. Revision 1.0 was released in 2005. 


Certified Wireless USB supports speeds of up to 480 Mbps at 3 m and 100 
Mbps at 10 m. The interface supports power-saving modes and uses encryption 
for security. The technology is ultrawideband (UWB) radio, which transmits in 
short bursts at very low power over a wide frequency spectrum. The UWB tech- 
nology is defined in the ISO/IEC 26907/8 specifications, which evolved from 
specifications developed by the nonprofit WiMedia Alliance. 


A USB host can have a built-in Wireless USB interface or a wired connection to 
a USB device that functions as a host wire adapter (HWA) that communicates 
via Wireless USB. In a similar way, a USB device can have a built-in Wireless 
USB interface or a wired connection to a device wire adapter (DWA) that com- 
municates via Wireless USB. 


Products with Certified Wireless USB interfaces have been slow to reach the 
market. Development kits have been expensive, making the interface impracti- 
cal for many developers. However, notebook PCs with built-in Wireless USB 
interfaces are available, and in time development tools will likely become more 


affordable. 


Cypress WirelessUSB 
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For low-speed devices, including HIDs, Cypress Semiconductor offers the 
WirelessUSB technology. The obvious market is wireless keyboards, mice, and 
game controllers. With a wireless range of up to 50 m, the technology is also 
useful for building and home automation and industrial control. The wireless 
interface uses radio-frequency (RF) transmissions at 2.4 GHz in the unlicensed 
Industrial, Scientific, and Medical (ISM) band. 


A WirelessUSB system consists of a WirelessUSB bridge and one or more Wire- 
lessUSB devices (Figure 19-11). The bridge translates between USB and the 
wireless protocol and medium. The WirelessUSB device carries out the device’s 
function (mouse, keyboard, game controller) and communicates with the 
bridge. 

The bridge contains a USB-capable microcontroller and a WirelessUSB trans- 
ceiver chip and antenna. The WirelessUSB device contains a Cypress PsOC or 
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Figure 19-11. WirelessUSB provides a way to design low-speed devices that use 
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another microcontroller and a WirelessUSB transmitter or transceiver chip and 
antenna. A device with a transceiver is 2-way: the device can communicate in 
both directions. A device with just a transmitter is 1-way: the device can send 
data to the host but cant receive data or status information. In both the bridge 
and device, the transmitter and transceiver chips use the SPI synchronous serial 
interface to communicate with their microcontrollers. 


In a 2-way system, when a device has data to send to the host, the device’s 
microcontroller writes the data to the transceiver chip, which encodes the data 
and sends it through the air to the bridge’s transceiver. On receiving the data, 
the bridge returns an acknowledgement to the device, decodes the data, and 
sends the data to the host in conventional USB interrupt or control transfers. 
On failing to receive an acknowledgement from the bridge, the device resends 
the data. 


When the host has data to send to the device, the host writes the data to the 
bridge’s USB controller, which returns ACK (if not busy and the data is 
accepted) and passes the data to the bridge’s transceiver. The transceiver 
encodes the data and sends it through the air to the WirelessUSB device. The 
device returns an acknowledgement to the bridge. On receiving a NAK or no 
reply, the bridge resends the data. 


In a 1-way system, a device sends data to the host in much the same way as in a 
2-way system except the device receives no acknowledgement from the host. To 
help ensure that the bridge and host receive all transmitted data, the device 
sends its data multiple times. Sequence numbers enable the bridge to identify 
previously received data. 


With both systems, the host thinks it’s communicating with an ordinary HID 
and has no knowledge of the wireless link. 


A WirelessUSB link can have a data throughput of up to 62.5 kbps, but 
low-speed throughput is limited by the USB bandwidth available for low-speed 
control and interrupt transfers. A device and its bridge must use the same fre- 
quency/code pair. A single WirelessUSB bridge can use multiple fre- 
quency/code pairs to communicate with multiple devices. For faster 
performance, the microcontroller can use burst reads to read multiple registers 
in the WirelessUSB chip in sequence. 


Other Options 


Other ways to use USB in wireless devices include various wireless bridges and a 
wireless networking option. 
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ZigBee is an inexpensive, low-power, RF interface suitable for building and 
industrial automation and other applications that transmit at up to 250 kbps 
and over distances of up to 500 m. DLP Design’s DLP-RF1 USB/RF OEM 
Transceiver Module provides a way to monitor and control a Zigbee interface 
from a USB port. The modules USB controller is FTDI's FT245BM. One or 
more DLP-RF2 RF OEM Transceiver Modules can communicate with the 
DLP-RF1. 


The IrDA bridge class described in Chapter 7 defines a way for a USB device to 


use bulk transfers to communicate over an infrared link. 


Another option is a vendor-specific wireless bridge that uses infrared, RF, or 
other wireless modules designed for use in robotics and other low- to moder- 
ate-speed applications. The bridge functions as a wired USB device that also 
supports a wireless interface. A remote device that supports the wireless inter- 
face carries out the peripheral’s function. Firmware passes received wireless data 
to the host and passes received USB data to the device. 


To use an existing USB device wirelessly, you may be able to use one of the 
USB/Ethernet products described earlier in this chapter along with a wireless 
network interface between the host PC and the hub/server. 
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Hosts for Embedded 
Systems 


A USB host in a desktop system has many responsibilities, including support- 
ing multiple bus speeds, managing communications with multiple devices, and 
providing power to every device connected to the root hub. PCs and other 
desktop computers have the resources to implement a full USB host. But many 
smaller systems can also benefit by functioning as hosts. A camera can connect 
to a USB printer. A data-acquisition device can store its data in a USB drive. A 
PDA can interface to a USB keyboard and mouse. 


For many of these smaller, embedded systems, a conventional USB host is 
impractical and unnecessary. These systems typically communicate with just 
one or a few devices with defined requirements for bus power and might not 
need to support hubs. 

A solution is to implement a limited capability host. For some applications, the 
best approach is a dual-role device that can switch functions between host and 
device as needed. Other applications require only host capability or require 
simultaneous host and device functions. USB supports all of these options. 
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USB On-The-Go 


The On-The-Go (OTG) Supplement to the USB 2.0 specification defines a 
way for a USB device to function as a limited-capability host and as a peripheral 
(though not both at the same time). Version 1.0 of the OTG supplement was 
released in 2001. Version 1.3 was released in 2006. 

When functioning as a host, the OTG device can communicate with the 
devices in its targeted peripheral list. Targeted peripherals can be any combina- 
tion of other OTG devices and peripheral-only devices. 


Capabilities and Limits 


Table 20-1 compares the requirements of an OTG device functioning as a host 
and a conventional (not OTG) host. An OTG host doesn’t have to support 
external hubs, multiple devices attached at the same time, or high and low 
speeds. 


Because OTG communications often involve battery-powered devices, conserv- 
ing power is important. For this reason, an OTG device that is providing VBUS 
is allowed to turn off VBUS when the bus is idle. 


Communications occur in sessions. A session begins when VBUS is above the 
session-valid threshold voltage and ends when VBUS falls below this voltage. 
The Session Request Protocol (SRP) enables a device to request a session even if 
VBUS isnt present. 


The OTG Connector 


An OTG device must have one and only one Micro-AB receptacle, which can 
accept either a Micro-A plug or a Micro-B plug. For SuperSpeed devices, the 
USB 3.0 specification defines a USB 3.0 Micro-AB receptacle and USB 3.0 
Micro-A plug. The Micro-A plugs are approved for use only with OTG devices. 
There is no approved Micro-A receptacle. The original OTG supplement speci- 
fied a Mini-AB receptacle, but the USB-IF deprecated this option in 2007 and 
requires new designs to use the Micro-AB. For existing OTG devices with 
Mini-AB receptacles, substitute Mini- for Micro- in the connector discussions 
in this chapter. 


The A-Device and B-Device 
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Every OTG connection is between an A-device and a B-device. The A-device is 
defined by the type of plug inserted in the USB receptacle. The A-device is 
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Table 20-1: Compared to a non-OTG host, an OTG device functioning as a host 
doesn’t have to supply as much power and can use a single connector for host 
and peripheral functions. 
































Capability or Feature USB 2.0 USB 2.0 OTG Device 
Conventional Host Functioning as a Host 
Communicate at high speed yes optional 
Communicate at full speed yes yes 
Communicate at low speed yes optional (not allowed in 
device mode) 
Support external hubs yes optional 
Provide targeted peripheral list no yes 
Function as a peripheral no yes (when not 
functioning as a host) 
Support Session Request Protocol optional yes 
Support Host Negotiation Protocol no yes 
Minimum available bus current per port |500 mA (100 mA if 8 mA 
battery-powered) 
OK to turn off VBUS when unneeded? — |no yes 
Connector 1 or more Standard A 1 Micro AB 








either a host with a Standard-A plug inserted or an OTG device with a micro-A 
plug inserted. The device at the other end of the cable is the B-device. Initially, 
the A-device functions as the host, and the B-device functions as the peripheral. 
As described below, two connected OTG devices can use a protocol to swap 
functions when needed. The A-device always provides the VBUS voltage and 
current even when functioning as a peripheral. 


Requirements for an OTG Device 
A USB 2.0 OTG device must provide all of the following: 


* The ability to function as a full-speed peripheral. Support for high speed is 
optional. The peripheral function must not use low speed. 

* The ability to function as a host that can communicate with one or more 
full-speed devices. Support for low speed, high speed, and hubs is optional. 

* Support for the Host Negotiation Protocol which enables two OTG 
devices to swap roles. (The host becomes the peripheral and the peripheral 
becomes the host.) 
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* The ability to initiate and respond to the Session Request Protocol, which 
enables a device to request communications with the host even if VBUS isnt 
present. 

* Support for remote wakeup. 

* Oneand only one Micro-AB receptacle, which can accept either a Micro-A 
plug or a Micro-B plug. 


A targeted peripheral list that names the devices the host can communicate 
with. 


* When functioning as the A-device, the ability to provide at least 8 mA of 
bus current or the amount required by the targeted peripherals, whichever 
is greater. 


* A display or other way to communicate messages to users. 


OTG adds complexity by requiring hosts to support the Host Negotiation Pro- 
tocol and Session Request Protocol and requiring the ability to function as a 
peripheral. On the other hand, OTG reduces complexity and expense by using 
a single receptacle and by not requiring the host to supply large bus currents or 
support external hubs or all bus speeds. 


The following paragraphs describe the requirements for OTG devices in more 
detail. 


Full-speed Device Capability 


Any device that implements OTG's limited-capability host must also be able to 
function as a USB peripheral. OTG host-only products aren't allowed. When 
functioning as a peripheral, an OTG device may support high speed and must 
not communicate at low speed. 


Full-speed Host Capability 


An OTG device functioning as a host must be able to communicate with one or 
more devices. The host must support full speed and may support low speed 
and/or high speed. The host doesnt have to support communications via hubs. 


The Host Negotiation Protocol 


The Host Negotiation Protocol (HNP) enables a B-device to request to func- 
tion as a host. When connecting two OTG devices to each other, users don't 
have to worry about which end of the cable goes where. When necessary, the 
devices use HNP to swap roles. 


Hosts for Embedded Systems 


When two OTG devices connect to each other, the A-device enumerates the 
B-device in the same way that a standard USB host enumerates its devices. Dur- 
ing enumeration, the A-device retrieves the B-device’s OTG descriptor, which 
indicates whether the B-device supports HNP. If the B-device supports HNP, 
the A-device can send a Set Feature request with a request code of hnp_enable. 
The request informs the B-device that it can use HNP to request to function as 
the host when the bus is suspended. 


At any time after enumerating, if the A-device has no communications for the 
B-device, the A-device suspends the bus. A B-device that supports HNP may 
then request to communicate. The B-device can use HNP in response to user 
input such as pressing a button, or firmware can initiate HNP without user 
intervention. 


An OTG A-device must support HNP. An OTG B-device must support HNP 
if the device’s targeted peripheral list includes any OTG device. This require- 
ment ensures that an OTG B-device can request to access the peripheral func- 
tion of a supported OTG device. If the targeted peripheral list includes no 
OTG devices, the OTG B-device isn’t required to support HNP because the 
peripherals will never use it. 

Standard hubs don’t recognize HNP signaling. If a hub is between the B-device 
and the A-device, the A-device must not send the hnp_enable request and the 
B-device can't use HNP. 

When idle or functioning as a host, an OTG device should switch in its 
pull-down resistors on D+ and D-. When functioning as a peripheral, an OTG 
device should switch out its pull-down resistor on D+ only. 


Requesting to Operate as a Host 

This is the protocol the B-device uses to request to operate as the host: 

1. The A-device suspends the bus. 

2. If the devices were communicating at full speed, the B-device removes itself 
from the bus by switching out its pull-up resistor on D+. If the devices were 
communicating at high speed, the B-device switches in its pull-up on D+ for 1— 
147 ms, then switches the pull-up out. The bus is in the SEO state. 

3. The A-device detects the SEO and connects to the bus as a device by switch- 
ing in its pull-up resistor on D+. The bus is in the J state. 

4. The B-device detects the J state and resets the bus. 

5. The B-device enumerates the A-device and can then perform other commu- 
nications with the device. 
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Returning to Operation as a Peripheral 
When finished communicating, the B-device returns to its role as a peripheral 
using the following protocol: 


1. The B-device stops all bus activity and may switch in its pull-up resistor. 


2. The A-device detects a lack of activity for at least 3 ms and switches out its 
pull-up resistor or removes VBUS to end the session. 


3. If VBUS is present and the B-device didn’t switch in its pull-up in Step 1, the 
B-device switches in its pull-up to connect as a peripheral. The bus is in the J 
state. 


4, If VBUS is present, the A-device resets the bus. The A-device can then enu- 
merate and communicate with the B-device, suspend the bus, or end the session 
by removing VBUS. 


The Session Request Protocol 


If the A-device has turned off the VBUS voltage, a B-device can use the Session 
Request Protocol (SRP) to request the host to restore VBUS and begin a new 
session. The two SRP methods are data-line pulsing and VBUS pulsing. The 
B-device must try data-line pulsing first, followed by VBUS pulsing. An 
A-device that supports SRP must respond to one of the methods. 


An A-device must respond to SRP if the device ever turns off VBUS while a 
micro-A plug is inserted. A B-device must support initiating SRP if the device 
wants to request communications with an OTG device when VBUS is off. A 
B-device whose targeted peripheral list has no devices that support SRP will 
have no need to initiate SRP. 


In data-line pulsing, the device switches in its pull-up (on D+ or D-, depending 
on device speed) for 5—10 ms. In VBUS pulsing, the device must drive the 
VBUS line long enough for the host to detect the VBUS voltage but not long 
enough to damage a non-OTG host that isnt designed to withstand a voltage 
applied to VBUS. Because VBUS capacitance is much higher on a non-OTG 
host, the voltage rises more slowly. Within 5 seconds of detecting data-line 
pulsing or VBUS pulsing, the A-device must turn on VBUS and reset the bus. 


Standard hubs don’t recognize SRP signaling, so if there is a hub between the 
B-device and the A-device, the B-device can’t use SRP. Non-OTG USB periph- 
erals also have the option to support SRP. 
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Support for Remote Wakeup 


When VBUS is present and the bus is suspended, an OTG device can use 
remote wakeup to request communications from an OTG device or other USB 
host. 


Cables and Connectors 


A device with a Micro-AB receptacle is an OTG device. Every OTG device 
must have one and only one Micro-AB receptacle, and any device with a 
Micro-AB connector must function as a OTG device. The Micro-AB receptacle 
can accept either a Micro-A plug or a Micro-B plug. 


Figure 20-1 shows the cabling options. Two OTG devices connect to each other 
via a cable with a Micro-A plug on one end and a Micro-B plug on the other 
end. It doesn’t matter which device has which plug. 


A host or upstream hub connects to an OTG device via a Standard-A to 
Micro-B cable. A peripheral with a Micro-B receptacle connects to an OTG 
device with a Micro-A-to-Micro-B cable. A peripheral with a permanently 
attached cable with a Micro-A plug attaches directly to the OTG device. 


A peripheral with a Standard-B or Mini-B plug or a captive cable with a Stan- 
dard-A plug must use an adapter to connect to an OTG device. The adapter has 
a Micro-A plug and a Standard-A receptacle. The Micro-A plug attaches to the 
OTG device. The Standard-A receptacle accepts a Standard-A plug from a cable 
that attaches to the peripheral with a Standard-B or Mini-B plug or a captive 
cable. This adapter is the only approved adapter for standard USB cables. 
Micro-A, Micro-B, and Micro-AB connectors have an ID pin that enables an 
OTG device to determine whether a Micro-A or Micro-B plug is attached. In a 
Micro-A plug, the ID pin is grounded. In a Micro-B plug, the ID pin is open or 
connected to ground via a resistance greater than 1MQ. (The MicroUSB 
Micro-B ID Pin Resistance ECN raised this value from its original 100kQ.) An 
OTG device typically has a pull-up resistor on the ID pin. If the pin is a logic 
low, the attached plug is a Micro-A. If the pin is a logic high, the attached plug 
is a Micro-B. 

The USB 3.0 specification defines a USB 3.0 Micro-AB receptacle and USB 
3.0 Micro-A plug that include contacts for SuperSpeed traffic. 
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Figure 20-1. An OTG device can communicate with a USB host or a device on 
the OTG device’s target peripheral list. 


Bus Current 


The ability to draw up to 500 mA per port from the bus is a convenience for 
users and a cost saver for device manufacturers. But providing this much cur- 
rent, or even the 100 mA that USB 2.0 battery-powered hosts must provide, 
can be a burden for some hosts. Some peripherals, including battery-powered 
ones, may not need bus power at all. 
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For these reasons, OTG devices have more flexible requirements for providing 
bus current. A USB 2.0 OTG device must provide the greater of 8 mA of bus 
current or the maximum amount the devices on the targeted peripheral list 
require, up to 500 mA. 

To conserve power, an A-device can leave VBUS unpowered until the device 
detects SRP signaling or launches an application that uses USB. For faster 
response when a device is attached, an A-device can have an option to power 
the bus on detecting device attachment. 


User Messages 


Every OTG device must have a display or another means to display error mes- 
sages to users. To pass compliance tests, an OTG device should support these 
messages: 


Device not connected/responding. A device isn’t working as expected. 


Attached device not supported. A device isn't on the targeted peripheral list or a 
B-device is drawing more current than the A-device supports. 

Unsupported hub topology. The device doesn't support hubs, the bus has more 
hub tiers than the A-device supports, or the bus is using another unsupported 
hub topology. 

A very basic messaging system is a series of LEDs with each labeled with an 
error message. 


The Targeted Peripheral List 


Every OTG device must have a targeted peripheral list that names the devices 
the manufacturer has successfully tested with the OTG device. For each periph- 
eral, the list should name the manufacturer and model number and describe the 
device. The list should not claim to support an entire class or other devices sim- 
ilar to those on the list. The OTG supplement doesn’t say where the list must 
appear. 


The OTG Descriptor 


During enumeration, a device that supports HNP or SRP must include an 
OTG descriptor (Table 20-2) in the descriptors returned in response to a Get 
Descriptor request for the Configuration descriptor. The bmAttributes field 
tells whether the device supports HNP and SRP. A device that supports HNP 
must support SRP. The A-device doesn’t need to know in advance if a device 
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Table 20-2: The OTG Descriptor indicates whether a device supports 
HNP and SRP. 











Offset Field Size Description 

0 bLength 1 Descriptor length (3) 
1 bDescriptorType 1 OTG (9) 

2 bmAttributes 1 D2-D7: reserved, 


D1: 1 = HNP supported, 

0 = HNP not supported 
DO: 1 = SNP supported, 

0 = SNP not supported 














supports SRP, but this information is included in the descriptor for use in com- 
pliance testing. 


Feature Codes for HNP 


The OTG supplement defines three codes for use in Set Feature requests. 


A code of b_hnp_enable (03h) informs the B-Device that it can use HNP. The 
A-device sends this request if all of the following are true: the A-device supports 
HNP, the A-device will respond to HNP when the bus is suspended, and the 
B-device connects directly to the A-device with no hubs in between. 


A code of a_hnp_support (04h) informs the B-device that the A-device sup- 
ports HNP and the B-device is directly connected (no hubs). The A-device can 
send this request before configuring the B-device. The A-device can then enable 
HNP at a later time when the A-device is finished using the bus. 

A code of a_alt_hnp_support (05h) notifies the B-device that the currently con- 
nected port does not support HNP, but that the A-device has an alternate port 
that does support HNP. 


Other Host Options 
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Some embedded hosts dont need to function as a device at all, or they need to 
support host and device functions at the same time. For these applications, the 
USB-IF document Requirements and Recommendations for USB Products with 
Embedded Hosts and/or Multiple Receptacles offers guidance. 


The document specifies logo requirements and presents additional recommen- 
dations for products that contain embedded host ports. Like OTG hosts, these 
hosts have limited resources and generally don't run general-purpose, 
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user-installed software. The hosts may provide one or more device ports that 
function simultaneously with the host port. 


Requirements 


Table 20-3 compares embedded hosts and conventional hosts. Requirements 
for embedded hosts are similar to those for the host function of OTG devices. 


Like an OTG device, an embedded host must provide a targeted peripheral list. 
Two versions of the list provide information for compliance testing and for 
users. For compliance testing, the list includes Vendor ID and Product ID 
numbers for the peripherals. For users, the list includes manufacturer names 
and model numbers. The list may name specific peripherals or a class of prod- 
ucts such as mass storage along with specific tested devices in the class. The lists 
should indicate the supported speeds of the targeted peripherals. 


The targeted peripherals determine the amount of bus power the host must 
provide and the supported bus speeds and transfer types. For each port, a host 
with specific targeted peripherals must supply the greater of 8 mA of bus cur- 
rent or the maximum amount the devices on the targeted peripheral list require, 
up to 500 mA. A host that supports a class must supply 500 mA per port. A 
host can support any single speed or multiple speeds but must support the 
speeds required by the devices in the targeted peripheral list. The host must 
support bulk, interrupt, and isochronous transfers as needed according to the 
requirements of the targeted peripherals. 


Support for SRP and hubs is optional. A host that supports hubs can support a 
single hub only or the full tiered star topology of a conventional bus. 


On attachment of a peripheral or hub, the host must indicate whether it sup- 
ports the peripheral or hub configuration. 


As on a conventional host, all ports on an embedded host should support the 
same speeds and devices. To inform users that a host port has limited capabili- 
ties, a graphical indicator at the connector is recommended. For example, a port 
that supports only printers might display a printer icon. 


Device Ports 


An embedded system with a host function can also support one or more periph- 
eral functions with type-B connectors. Unlike OTG devices, the system can 
perform its host and peripheral functions at the same time. A data logger might 
have a Standard-A port that connects to a printer for printing logged data and a 
type-B port that connects to a conventional host for uploading data. The host 
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Table 20-3: Unlike an OTG device, a device that functions as an embedded host 
can also function as a peripheral at the same time. 





























Capability or Feature USB 2.0 USB 2.0 Embedded 
Conventional Host Host 
Communicate at high speed yes As needed to support 
Communicate at full speed yes targeted peripherals 
Communicate at low speed yes 
Support external hubs yes optional 
Provide targeted peripheral list no yes 
Function as a peripheral no optional, can be 
simultaneous with host 
function 
Support Session Request Protocol optional optional 
Minimum available bus current per port |500 mA (100 mA if 8mA 
battery-powered) 
Connector lor more Standard A lor more Standard A 








and device ports dont have to support the same speeds, but all device ports 
should support the same speeds. 


A non-OTG product that needs to function both as a device and as a host but 
not at the same time can use a vendor-specific connector. For operation as a 
device, the user attaches a cable that has a mating vendor-specific connector 
and a Standard-A plug. For operation as a host, the user attaches an adapter that 
has a mating vendor-specific connector and a Standard-A receptacle. 


Designers of products that have both Standard-A and type-B receptacles should 
use product design, labeling, and product literature to communicate the prod- 
ucts function to users and make it clear that the product isn’t a hub. 


Controller Chips 
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Several manufacturers offer controller chips designed for use in OTG devices 
and embedded hosts. To function as a peripheral, the controller must support 
functions similar to those in the controllers described in Chapter 6. As with 
other device controllers, some OTG and embedded-host controllers contain a 
CPU while others must interface to an external CPU. 


To function as an OTG host, the controller, possibly with the help of external 
circuits, must have the ability to send SOF packets, schedule and initiate Setup, 
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IN, and OUT transactions, provide VBUS, manage power, reset the bus, switch 
the pull-up and pull-down resistors as needed when changing roles, and detect 
the state of the ID pin. Some chips have internal charge pumps for supplying 
and controlling VBUS from a 3V supply. A controller may also provide timers, 
status signals, or other hardware support for SRP and HNP signaling. 


Microcontrollers 


Sources for microcontrollers with OTG and embedded-host capability include 
Cypress Semiconductor, Atmel, Microchip Technology, and NXP Semiconduc- 


tors. 


Cypress Semiconductor 


As the name suggests, Cypress Semiconductor’s CY7C67200 EZ-OTG control- 
ler is designed for use in OTG devices. The chip contains a 16-bit CPU and can 
function in two modes. In stand-alone mode, the controller is the device’s main 
CPU. The CPU can read firmware from an I C EEPROM. In coprocessor 
mode, the controller interfaces to an external CPU that manages USB commu- 
nications and other tasks. The CPU can communicate via either a parallel Host 
Peripheral Interface at up to 16 MB/s, a high-speed asynchronous serial inter- 
face at up to 2 Megabaud, or a Serial Peripheral Interface (SPI) at up to 2 Mbps. 


The EZ-OTG has two USB ports and two serial interface engines that support 
low and full speeds. One port can function as an OTG device, a non-OTG 
embedded host, or a peripheral-only device port. The other port can function 
as a non-OTG host or peripheral-only device port. 


The controller contains a ROM BIOS that executes an Idle task consisting of 
an endless loop that waits for an interrupt, executes the tasks in the Idle chain, 
and repeats. Firmware can add tasks to the Idle chain or replace the entire Idle 
task with device-specific programming. 


Firmware development can use the free GNU Toolset, which includes a C com- 
piler, assembler, make utility, linker, debugger and other utilities. Cypress pro- 
vides Frameworks C code for performing USB-related tasks and accessing other 
components in the controller. 


A tutorial and many examples are in the free e-book, USB Multi-Role Device 
Design By Example, by John Hyde, available from www. usb-by-example.com. 

A related chip, the CY7C67300 EZ-HOST, adds an interface to external mem- 
ory, two ports for each of the two SIEs, memory expansion capabilities, and 
more I/O features. 
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Atmel 


Atmel’s AVR series of microcontrollers includes the AT90USB1287, which has 
an OTG port that supports full and low speeds. The 8-bit chip has 128K of 
flash memory, 4K of EEPROM, and 8K of RAM. The 48 I/O bits support 
functions such as timer/counters, PWM channels, an ADC, USART, SPI, and 
analog comparator. A JTAG interface supports debugging. 


Atmel provides an AT90USBxxx USB software library in C with support for 
OTG functions. The AT90USB647 is similar but has less memory. 


Microchip Technology 


Microchip Technology offers 16-bit and 32-bit microcontrollers with OTG and 
embedded-host capability. Chips in the 16-bit PIC24FJ256GB110 family con- 
tain a module that can function as a full-speed peripheral or a low/full-speed 
OTG or embedded host. The chips have flash memory for program storage and 
support a variety of I/O functions in addition to USB. The 16-bit architecture 
builds on the 8-bit architecture of the PIC18F4550. Microchips USB Frame- 
work supports the PIC24F chips. 

Chips in the 32-bit PIC32MX family offer similar capabilities with faster per- 
formance. Microchip provides a separate USB device and host stack for these 
chips. 


NXP Semiconductors 


NXP Semiconductors offers a variety of ARM-based microcontrollers with 
OTG and embedded-host capability. One example is the LPC3180, which con- 
tains a 32-bit ARM926EJ-S processor. The full-speed USB port requires an 
interface to an external transceiver with an I?C interface such as the ST-NXP 
Wireless ISP1301. 


Interface Chips 
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Sources for OTG interface chips include ST-NXP Wireless and Oxford Semi- 
conductor. Also see the Cypress CY7C67200 EZ-OTG described above. 


ST-NXP Wireless 


ST-NXP Wireless’ ISP1362 is an interface-only chip for OTG devices. The 
chip contains an ISP1181B device controller and a host controller. Both con- 


Hosts for Embedded Systems 


trollers can communicate at full and low speeds. (The OTG device must use 
full speed when functioning as a peripheral.) 


The controller interfaces to an external CPU using a 16-bit interface that can 
transfer data at up to 10 MB/s. The external CPU communicates with the con- 
troller by accessing its registers and buffer memory. The registers are compatible 
with the registers defined in the OHCI host-controller specification. 


A descriptor defines a format for exchanging information with the host control- 
ler’s driver. The descriptor consists of a header that contains information such 
as the endpoint number, transaction type (Setup, IN, OUT), bus speed, tog- 
gle-bit value, and a completion code, followed by data. 

The chip contains two USB ports. One port can function as the OTG port in 
an OTG device or as a host or device port for a non-OTG host or device. The 
second port can function only as a host port and isn’t recommended for use in 
OTG devices. 

ST-NXP Wireless provides host, peripheral, and OTG drivers for PCI plat- 
forms running Linux, Windows CE, DOS, and the FlexiUSB real-time operat- 
ing system and for Intel PXA250/Arm architecture platforms running Linux or 
Windows CE. 

The ISP1761 is an OTG controller that supports high speed and can use a 16- 
or 32-bit CPU interface. 


Oxford Semiconductor 

Oxford Semiconductor’s OXU210HP is a physically small, low-power interface 
chip especially suited for compact and inexpensive dual-role products. 

The controller supports low, full, and high speeds and interfaces to an external 
CPU using a 16- or 32-bit data bus. Two USB ports can operate as one host 
and one OTG device, one host and one peripheral, or two hosts. Hardware or 
software can handle HNP. The chip supports multiple power-saving modes and 
a selectable clock frequency. 


Driver options include host and peripheral drivers for Windows CE and Linux 
and USBLink drivers for real-time OSes. 


The chip is one in a series of OTG-capable chips from Oxford Semiconductor. 
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I hope you've found this book useful. For more about USB developing, includ- 
ing device and host example code and links to product information, tutorials, 
articles, news, and updates, please visit my website at www. Lvr.com. 
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monitor control (HID) 180 

MouseWarrior 182 


169, 170 
169, 174 


MSIL 244 
Multi-interface Function Device Class 
Codes 106 


N 


NAK 47 

NAK PID 42 

NDIS 169 

NET 212-213 
APIcalls and 243-252 
findinga device 252-262 
See also example code. 


NET2272 157-159 
RDK 145-146 
network 


accessing devices over 455 
See also Ethernet control model; Ethernet 
emulation model; NDIS 
noise sources 462 
notification 
CDC 170 
device (Windows) 265-275 
notification (SuperSpeed) 57 
Function Wake 406 
Latency Tolerance Message 406 
Notification usage 111 
NRDY 
controltransfers and 65 
Transaction Packet 54 
NRZI 430 


Index 


NTamd64 235 

NT-based 12 

NTia64 235 

NTx86 235 

NumP 57,58,59 

in bulk transfers 72 

in control transfers 65 
NXP Semiconductors 148 
controllers 484 

See also ST-NXP Wireless; specific chip 
NYET 48 

control transfers and 65 
in bulk transfers 71 

in control transfers 121 
PID 42 


O 


OBEX 172,175 
OHCI 216 
interrupt transfers and 78 
vs. UHCI 216-217 
On-The-Go. See OTG 
Open Host Controller Interface. See OHCI. 
Ordered Set 438 
oscillator, in device 139 
OTG 
A-device and B-device 472 
bus current 478 
cables 477 
chips 482-485 
connector 472 
descriptor 115, 479 
requirements 472, 473-479 
Supplement 472 
targeted peripheral list 479 
user messages 479 
other_speed_configuration descriptor 105 
OUT 
defined 34 
PID 42 
transaction 35 
Output item (HID) 298, 299 
Output report 328-330 
API 317-318 
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Index 


over-current protection 397 
Oxford Semiconductor 485 
OXU210HP 485 


P 


packet 

delay between 434 

sequence (USB 2.0) 44-45 

short. See short packet 

size, maximum 101, 111-112 

SuperSpeed 53-59 
Packet ID. See PID. 
Packets Pending 56, 58 
padding (HID) 314 
page description language 
parallel port 

adapter 8 

compared to USB 3 

converting from 9-10, 204-205 
passphrase, mass storage 185 
PC 

as device 145-146 

connecting two 205-207 

See also host 
PCI device board 145-146 
PCI Express (PCIe) 457 
PCM2702/PCM2900 168 
PDL 190,191 
PDO 211 
PDT 187 
Periodic usage 111 
peripheral 19 

See also device 
personal healthcare class 
phase, transaction 41-44 
Phase-locked SOFs ECN 399 
phone. See telephone; cell phone 
physical descriptor 314 
physical interface device 180 
Physical Minimum and 

(HID) 306, 308-310 

PIC. See Microchip Technology; specific chip 
PIC18 controllers 148 

See also specific chip 


190, 191 


189-190 


Maximum 
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PIC18F4550 
PIC24FJ 484 
PIC32MX 484 
PICBASIC PRO 152 
descriptors 281 
HID code 293 
WinUSB and 349 
PID (packet ID) 41-44, 433 
error-checking bits 51 
sequencing 53 
PID (physical interface device) 180 
PIMA 15740 195-196 
PING (SuperSpeed) 407 
PING (USB 2.0) 49 
control transfers and 65 
in bulktransfers 71 
in control transfers 120 
PID 43 
PING_RESPONSE 407 
ping-pong buffer 139 
PInvoke (P/Invoke) 244 
pipe 
defined 36 
stream and message 38-39 
PL-2305 192 
PL-2501 206 
Platform Invocation Services 244 
Plug-and-Play 211,214 
PLX Technology 145-146, 158 
PNF 238,240 
PnP 211,214 
point of sale 181 
pointer 249 
port 
defined 19 
indicator (hub) 388 
PORT_RESET 122 
POS 181 
power 
bus. See bus power 
switch, soft-start 401 
Powered-B connector 460 
PowerOn Reset 438 
PRE PID 43, 44, 377, 381 
precompiled INF file 238 


148-152 


printer class 190-192 
INF file 239 
See also parallel port 
Product ID 
indescriptor 102 
INF fileand 236 
Prolific Technology 188, 192, 206 
propagation delay 454 
property page 225, 241 
protocol analyzer 
hardware 410-412 
software 412-413 
PS/2 182 
PSTN 170, 172 
PtrToStringAuto 245 
Public switched telephone network. See PSTN 
pull-up resistor 385, 392, 444 


Q 


quadruple buffers 139 
QuickUSB Module 145 


R 


RAM 

datamemory 141 

program memory 140, 141 
rawinput 182 
ReadFile 317, 330-339 
real-time transfers. See speed 
receiver 

high speed 445 

low/full speed 442 

SuperSpeed 457 
reference variable 249-250 
RegisterDeviceNotification 265-269 
registry 226-231 
Remote NDIS. See RNDIS 
remote wakeup 402 

bit 126 
removable devices and media 188 
repeater/forwarder (SuperSpeed hub) 386- 

387 

report descriptor 286-289 


Index 


ReportID 303-304 


request 
class specific 136 
standard 124-135 


vendor specific 136 
Request Error condition 122 
Request Type 118 
reset 

enumeration and 92, 93 

hot 438 

SuperSpeed 438 

warm 403 
Reset state 427-428 
Resume state 401, 427 
Retry bit 56 
risetime 454 
RNDIS 169, 175 
ROM (program memory) 140 
Root 2 USB Test Host 414 
roothub 15, 376 
Route String 56, 58, 387 
RPM Systems 414 
RS-232 

adapter 8 

converting from 204 

See also COM port, virtual; ELA/TIA-232 
RS-485 3,455 


S 


S1-S4 power states 407-408 
SafeHandle 249 
scrambling 436 
SCSI 185, 187 

USB Attached. See UASP 
SDK 212,245 
Sealevel Systems 465 
SECURITY ATTRIBUTES 262 
selective suspend 400 
Self-Powered bit 126 
self-powered device 392 
Sequence Number 55-56 
sequence number, header 55 
serial interface engine 138 
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Index 


serial number 
content security and 177 
driver installationand 242 
IOCTL for media 177 
mass storage and 187 
registry and 227 
serial port. See COM port, virtual; RS-232; 
RS-485 
Series A. See Standard-A connector 
Series B. See Standard-B connector 
service interval 56,112 
service key 231 
service, defined 39 
Session Request Protocol 476 
Set Address 93, 129 
Set Configuration 132 
Set Descriptor 131 
Set Feature 128 
Set Idle 289, 292 
Set Interface 133 
Set Isochronous Delay 95, 135 
Set Port Feature 122 
Set Protocol 289, 292 
Set Report 289, 291, 318 
Set SEL 95, 135, 406 
Setup 
Data Packet 65 
required ACK 70 
transaction 35 
SETUP PID 42 
Setup stage 62, 118-119 
SuperSpeed 65 
SetupAPI log file 240 
setupapidll 245 
SetupDiDestroyDeviceInfoList 253, 261 
SetupDiEnumDeviceInterfaces 253, 255- 
258 
SetupDiGetClassDevs 253, 254-255 
SetupDiGetDeviceInterfaceDetail 253, 
258-261 
shielding 464 
requirement (USB 2.0) 451 
short packet 45 
WinUSB 360 
SIE 138 
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signature, digital 423-424 
signed driver. See digital signature 
SilentInstall 229 
Silicon Laboratories 

controller chip 145, 148, 161 

development board 145 
Single-ended 0/1 426 
sleep (Windows) 407 
Sleep state 399, 401-402 
smartcard 192-194 

INF file 239 
SMSC 

controller chips 
SnoopyPro 413 
SOF 43-44, 385 

and low-power states 399 

PID 42 

synchronizing to 82 
soft-start power switch 401 
SOP 427 

See also HSSP 429 
Sourcequest, Inc. 413 
SourceUSB 413 
SPC 187 
specification 

Certified Wireless USB 466 

class 164 

ECNs 14 

OTG 472 

USB 1.0,1.1 11 

USB 2.0 12-13 

USB 3.0 13 

See also specific class 
speed 

bus 4 

considerations 16-18 

decidingon 142 

detecting 92-93 

detecting device 384-385 

USB 2.0 hub 383-385 

See also bandwidth; throughput 
SPI 

compared to USB 3 

EEPROM 141 
SPLIT PID 43, 44 


148, 188 


split transaction 379-382 
Squelch 429 
detecting 446 
SRP 476 
SSPLIT 380-381 
ST-NXP Wireless 
controllers 484 
transceiver 484 
See also NXP Semiconductors 
ST7260 148 
ST7265X 148 
ST7268x 148 
STALL 47-48 
in control transfer 50,65, 121, 122, 123 
PID 42 
Transaction Packet 54 
Standard Microsystems Corporation. See 
SMSC 
Standard-A connector 452 
Standard-B connector 451 
See also USB 3.0 Standard-B connector 
standby state 407-408 
star, tiered 15-16 
Start of Frame. See SOF 
Start-of-High-speed-Packet 429 
Status Change endpoint 383, 387, 393 
status codes 47-49 
status phase. See handshake phase 
Status stage 62, 121-122 
SuperSpeed 65 
Std A, Std B. See Standard-A connector; Stan- 
dard-B connector 
still image 
INF file 239 
still image class 194-197 
STMicroelectronics 148 
DFU driver 179 
Stream ID 58 
stream pipe 38 
string descriptor 113-114 
structure, passing 251-252 
Subtype (Transaction Packet) 


158, 188 


54, 57 


Index 


SuperSpeed 4 
detection circuit 457 
enumeration 95 
See also USB 3.0 
SuperSpeed endpoint 
descriptor 112-113 
burst transactions and 57 
SuperSpeed USB device 
descriptor 115 
Suspend state 400-401 
high speed 448 
SuperSpeed 403, 405-406 
Symbol 437 
symbolic link 221 
SYNC field 431, 433 
Synch Frame 134 
synchronization type 111 
system exit latencies 135 
%SystemRoot% 232 


T 


targeted peripheral list 479, 481 
TDR 446 
telephone 

cell 170 

network. See PSTN 
termination, high speed 445-447 
test and measurement class 197-198 
test modes 127, 128, 435-436 
testing 

compliance 415-419 

equipment 410-414 

logo 419-424 
Tetradyne Software, Inc. 203 
Texas Instruments 148, 168, 188 
Thesycon Systemsoftware & Consulting 

GmbH 175,203 

threads (host programming) 87 
throughput 24 

maximizing 86-88 
TIA/EIA-485. See RS-485 
tiebreaker 60 
tiered star 15-16 


companion 


capability 
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timeout 
HidD_GetFeature 342 
HidD_SetFeature 341 
ReadFile 330-331 
WinUSB 360 
WriteFlle 317-318 
timing reference (device) 139 
TMC. See test-and-measurement class 
token phase 43 
topology, bus 15-16 
TP. See Transaction Packet 
Trace Systems, Inc. 293 
traffic generator 414 
training, link 438 
transaction 
burst 57 
burst (isochronous) 84 
elements (USB 2.0) 39-46 
split. See split transaction 
SuperSpeed 53-59 
Transaction Packet 53 
transaction translator 377-382 
transceiver 138 
USB2.0 439-449 
USB 3.0. See transmitter (USB 3.0); receiver 
(USB 3.0) 
transfer 
defined 39 
types 37 
See also bulk transfer; control transfer; in- 
terrupt transfer; isochronous trans- 
fer 
transmitter (USB 3.0) 457 
trusted publisher 423 
TUSB3200A 168 
TUSB3210/3410 148 
TUSB3410 184 
TUSB6250 148,188 
twinaxial cable 457 
twisted pair 457, 463-464 


U 


U0-U3 link states 403-405 
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U1_ENABLE and U2_ENABLE 
U3. See Suspend state 
UAA 169 
UASP 27,185 
UFI 185 
UHCI 216 
vs. OHCI 216-217 
UM232R/UM245R modules 161 
UMDF 218 
Universal Audio Architecture 169 
Universal Host Controller Interface. See 
UHCI 
universally unique identifier 115 
unmanaged code 244-247 
UnregisterDeviceNotification 275 
UOWN 149 
UPSunit 180 
upstream 15 
URB 214-215, 412 
Usage(HID) 287,311, 312 
Usage Page 286,304 
Usage Tables 181, 296, 305 
USB 
benefits for developers 5-7 
benefits for users 2-5 
compared with other interfaces 3 
history 11-15 
icon 452, 460 
limits 7-10 
logo 415,419 
speeds 4 
topology 15-16 
vs. Ethernet 10 
vs. IEEE-1394 11 
See also specification 
USB 1.0, USB 1.1. See USB 1.x 
USB 1.x 1l 
hub 383 
USB 2.0 
history 12-13 
USB 2.0 Extension 
descriptor) 114 
USB 2.0 Phase-locked SOFs 399 


127, 128 


(device capability 


USB 3.0 
frequently asked questions 27-30 
history 13 
See also SuperSpeed 
USB 3.0 Micro-B connector 458 
USB 3.0 Standard-A to USB 3.0 Standard-A 
cable 461 
USB 3.0 Standard-B connector 458 
USB Attached SCSI Protocol 27 
USBFIFO 159-161 
USB Implementers Forum. See USB-IF 
USB Server 455 
USB UART 159-161 
for host-to-host communications 207 
USB2005/USB222x 148 
usb8023.sys 175 
USBCAMD 202 
usbccgp.sys 175,214 
USBCV 416 
USBee EX2 Experimenter’s Board 145 
usbhub.sys 215 
USBDC/IO 145 
USB-IF 
about 7 
compliance tests 415-419 
usbportsys 215 
usbscan.sys 196 
usbser.sys 175 
usbstor.sys 188 
USBTMC. See test-and-measurement class 
usbvideo.sys 202 
USBwatch 293 
user mode 210 
user32.dll 245 
user-mode client driver 213 
using statement 244 


UUID 115 
UWB 466 


V.250 modem standard 169 
value variable 249-250 
variable type 249 


Index 


VBUS 
capacitance 393 
detecting 393 
USB 3.0 hub and 385 
voltage 390 
Vendor ID 
in registry 227 
INF file and 236, 240 
obtaining 10 
reading (HID) 321-323 
Vendor-specific class 101 
Verilog 138 
VHDL 138 
ViCAM-II 202 


video class 198-202 
virtual COM port 160, 173-175 
driver 175 


See also communications device class; USB 
UART; USB FIFO 

Vista Imaging 202 
Visual Basic. See example code; .NET 
Visual C£. See example code; .NET 
Visual C++ 244 
voltage 

back 393 

bus 390 

output (USB 2.0) 449 

See also VBUS 


W 


WS81E381 194 

Warm Reset 403, 438 

WDF 7,217 

WDK 217-219, 245 
devcon example 220 
GUIDsand 219 

WDM 213,217 

WHQL 238 

WIA 196 

WiMedia Alliance 466 

Winbond Electronics Corporation 194 

windex 119 

Y%windir% 232 

WindowProc. See WndProc 
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Windows 
API 212 
audio support 169 
CDC support 175 
content security support 177 
Device Manager 223-226 
HID support 184 
logo 422-424 
mass storage support 188 
power management 407-408 
printer support 192 
registry 226-231 
smart card support 194 
video support 202 
Windows 7 13 
Windows 95 11 
Windows 98 11 
Windows driver 
irda.sys 184 
usb8023.sys 175 
usbccgp.sys 175 
usbhub.sys 215 
usbportsys 215 
usbscan.sys 196 
usbser.sys 175 
usbstor.sys 188 
usbvideo.sys 202 
Windows Driver Foundation 7, 217 
Windows Driver Kit. See WDK. 
Windows Driver Model 213 
Windows Hardware Quality Labs 238 
Windows NT 12 
Winqual 422-423 
WinUSB 
assigning 349-350 
firmware 346-349 
INF file 235 
requirements 345-346 
See also WinUSB_xxxx functions 


504 


WinUsb_ControlTransfer 368-371 
WinUsb_Free 371-372 
WinUsb Initialize 350-352 
WinUsb QueryInterfaceSettings 352-354 
WinUsb QueryPipe 354-358 
WinUsb ReadPipe 366-367 
WinUsb SetPipePolicy 359-364 
WinUsb WritePipe 364-366 
wire gauge. See AWG 
Wireless Controller class 101 
wireless interface 465-469 
wireless mobile communications 169, 170 
Wireless USB 466 

device capability descriptor 114 
WirelessUSB (Cypress) 466-468 
wLANGID 114 
wLength 119 
WM_DEVICECHANGE 265,266 
wMaxPacketSize 111 
WMC 169,170, 172 

driver 175 
WndProc 265, 269-270 
WPF subsystem 192 
WriteFile 317, 328-330 


wValue 119 
X 
xHCI 216 
Z 


zero-length Data Payload 54 
in control transfer 68 
zero-length packet. See ZLP 
ZigBee 469 
ZLP 
defined 45 
in control transfer 50, 68, 120, 121 


